From owner-freebsd-doc@FreeBSD.ORG Sun Jul 13 15:20:17 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 97DF937B404 for ; Sun, 13 Jul 2003 15:20:17 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3C82B43F93 for ; Sun, 13 Jul 2003 15:20:16 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h6DMKGUp019974 for ; Sun, 13 Jul 2003 15:20:16 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h6DMKGVm019973; Sun, 13 Jul 2003 15:20:16 -0700 (PDT) Resent-Date: Sun, 13 Jul 2003 15:20:16 -0700 (PDT) Resent-Message-Id: <200307132220.h6DMKGVm019973@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Ken Smith Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 33D0737B401 for ; Sun, 13 Jul 2003 15:17:52 -0700 (PDT) Received: from zeus.cse.buffalo.edu (zeus.cse.Buffalo.EDU [128.205.32.30]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6EBC343F93 for ; Sun, 13 Jul 2003 15:17:51 -0700 (PDT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from zeus.cse.buffalo.edu (localhost.cse.buffalo.edu [127.0.0.1]) h6DMGRew045684; Sun, 13 Jul 2003 18:16:27 -0400 (EDT) Received: (from kensmith@localhost) by zeus.cse.buffalo.edu (8.12.8p1/8.12.8/Submit) id h6DMGQ9a045683; Sun, 13 Jul 2003 18:16:26 -0400 (EDT) Message-Id: <200307132216.h6DMGQ9a045683@zeus.cse.buffalo.edu> Date: Sun, 13 Jul 2003 18:16:26 -0400 (EDT) From: Ken Smith To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: kensmith@cse.Buffalo.EDU Subject: docs/54456: Minor fixes to fdp-primer docs X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Ken Smith List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 Jul 2003 22:20:17 -0000 >Number: 54456 >Category: docs >Synopsis: Minor fixes to fdp-primer docs >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jul 13 15:20:15 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Ken Smith >Release: FreeBSD 4.8-RELEASE i386 >Organization: U. Buffalo CSE Department/FreeBSD >Environment: System: FreeBSD zeus.cse.buffalo.edu 4.8-RELEASE FreeBSD 4.8-RELEASE #0: Thu Apr 3 10:53:38 GMT 2003 root@freebsd-stable.sentex.ca:/usr/obj/usr/src/sys/GENERIC i386 >Description: One of the examples has one too many tags in it. Since I was mentioning that I included some mis-spellings (ispell agrees with me) and a filename change (typically setting environment variables is done in a .cshrc file - but there may have been a reason they used .login I'm not aware of...). >How-To-Repeat: N/A >Fix: Apply diff's below (relative to ftp-primer directory)... --- overview/chapter.sgml.orig Sun Jan 12 13:31:41 2003 +++ overview/chapter.sgml Sat Jul 12 22:25:39 2003 @@ -39,7 +39,7 @@ is produced. Your contributions are very valuable. This document's main purpose is to clearly explain how - the FDP is organised, how to write and submit + the FDP is organized, how to write and submit documentation to the FDP, and how to effectively use the tools available to you when writing documentation. --- sgml-markup/chapter.sgml.orig Wed May 21 17:05:04 2003 +++ sgml-markup/chapter.sgml Sat Jul 12 22:33:24 2003 @@ -292,7 +292,7 @@
Term 1
-

Paragraph 1 of definition 1.

+

Paragraph 1 of definition 1.

Paragraph 2 of definition 1.

--- sgml-primer/chapter.sgml.orig Sun Jan 12 13:31:41 2003 +++ sgml-primer/chapter.sgml Sat Jul 12 23:35:28 2003 @@ -119,7 +119,7 @@ these other markup languages. A meta markup language. - This is exactly what the Standard Generalised Markup Language (SGML) + This is exactly what the Standard Generalized Markup Language (SGML) is. Many markup languages have been written in SGML, including the two most used by the FDP, HTML and DocBook. @@ -369,7 +369,7 @@ - <filename>.login</filename>, for &man.csh.1; and + <title><filename>.cshrc</filename>, for &man.csh.1; and &man.tcsh.1; users setenv SGML_ROOT /usr/local/share/sgml --- structure/chapter.sgml.orig Sun Jan 12 13:31:42 2003 +++ structure/chapter.sgml Sun Jul 13 00:18:03 2003 @@ -45,7 +45,7 @@ promote consistency between the different documentation - organisations, to make it easier to switch between working on + organizations, to make it easier to switch between working on different documents @@ -168,14 +168,14 @@ sect3) and so on. - Physical organisation + Physical organization There are a number of files and directories within the handbook directory. - The Handbook's organisation may change over time, and this - document may lag in detailing the organisational changes. If you + The Handbook's organization may change over time, and this + document may lag in detailing the organizational changes. If you have any questions about how the Handbook is organised, please contact the &a.doc;. @@ -259,7 +259,7 @@ Chapters and/or directories should not be named in a fashion that reflects their ordering within the Handbook. This ordering might change as the content within the Handbook is reorganised; - this sort of reorganisation should not (generally) include the + this sort of reorganization should not (generally) include the need to rename files (unless entire chapters are being promoted or demoted within the hierarchy). >Release-Note: >Audit-Trail: >Unformatted: