From marc@blackend.org  Sat May 25 04:30:10 2002
Return-Path: <marc@blackend.org>
Received: from abigail.blackend.org (blackend.org [212.11.50.35])
	by hub.freebsd.org (Postfix) with ESMTP id A7EB937B40B
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 25 May 2002 04:30:07 -0700 (PDT)
Received: from abigail.blackend.org (localhost [127.0.0.1])
	by abigail.blackend.org (8.12.3/8.12.3/ - 15/04/02) with ESMTP id g4PBRDNI043039
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 25 May 2002 13:27:13 +0200 (CEST)
	(envelope-from marc@abigail.blackend.org)
Received: (from marc@localhost)
	by abigail.blackend.org (8.12.3/8.12.3/Submit) id g4PBRDQS043038;
	Sat, 25 May 2002 13:27:13 +0200 (CEST)
	(envelope-from marc)
Message-Id: <200205251127.g4PBRDQS043038@abigail.blackend.org>
Date: Sat, 25 May 2002 13:27:13 +0200 (CEST)
From: Marc Fonvieille <marc@blackend.org>
Reply-To: Marc Fonvieille <marc@blackend.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: sysinstall application name should be Sysinstall with right tags in all the Handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         38540
>Category:       docs
>Synopsis:       [patch] make application name capitalization consistent in Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat May 25 04:40:01 PDT 2002
>Closed-Date:    Wed May 28 00:16:41 UTC 2008
>Last-Modified:  Wed May 28 00:16:41 UTC 2008
>Originator:     Marc Fonvieille
>Release:        FreeBSD 4.6-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD abigail.blackend.org 4.6-PRERELEASE FreeBSD 4.6-PRERELEASE #5: Sun May 12 00:30:43 CEST 2002 marc@abigail.blackend.org:/usr/src/sys/compile/ABIGAIL i386


	
>Description:
After my previous PR i did a search in the Handbook for sysinstall, and
i found several instances without application tags and/or using 
sysinstall instead of Sysinstall. Read the patches below for more 
details.
	
>How-To-Repeat:
	
>Fix:

	

--- diff1 begins here ---
diff -ruN handbook.org/advanced-networking/chapter.sgml handbook/advanced-networking/chapter.sgml
--- handbook.org/advanced-networking/chapter.sgml	Thu May 16 03:42:20 2002
+++ handbook/advanced-networking/chapter.sgml	Sat May 25 12:07:29 2002
@@ -3383,8 +3383,8 @@
         <indexterm>
           <primary><application>sysinstall</application></primary>
         </indexterm>
-        <para>DHCP is supported by <application>sysinstall</application>.
-          When configuring a network interface within sysinstall, 
+        <para>DHCP is supported by <application>Sysinstall</application>.
+          When configuring a network interface within <application>Sysinstall</application>, 
           the first question asked is, "Do you want to try DHCP
           configuration of this interface?"  Answering affirmatively will
           execute <command>dhclient</command>, and if successful, will fill 
@@ -5274,7 +5274,7 @@
 	the <filename>/etc/rc.conf</filename> system.  The
 	<literal>inetd_enable</literal> option is set to
 	<quote>NO</quote> by default, but is often times turned on by
-	<application>sysinstall</application> with the medium security
+	<application>Sysinstall</application> with the medium security
 	profile.  Placing:
 	<programlisting>inetd_enable="YES"</programlisting> or
 	<programlisting>inetd_enable="NO"</programlisting> into
--- diff1 ends here ---

--- diff2 begins here ---
diff -ruN handbook.org/disks/chapter.sgml handbook/disks/chapter.sgml
--- handbook.org/disks/chapter.sgml	Thu May 16 03:42:27 2002
+++ handbook/disks/chapter.sgml	Sat May 25 12:08:56 2002
@@ -213,7 +213,7 @@
 	  <title>Disk Label Editor</title>
 	  <indexterm><primary>BSD partitions</primary></indexterm>
 
-	  <para>Next, you need to exit <application>sysinstall</application>
+	  <para>Next, you need to exit <application>Sysinstall</application>
             and start it again.  Follow the directions above, although this
             time choose the <literal>Label</literal> option. This will
 	    enter the <literal>Disk Label Editor</literal>.  This
@@ -230,14 +230,14 @@
 	    entire disk in dedicated mode, or the entire FreeBSD slice in
 	    slice mode.  The other partitions are for general use.</para>
 
-	  <para><application>sysinstall</application>'s Label editor 
+	  <para><application>Sysinstall</application>'s Label editor 
 	    favors the <literal>e</literal>
 	    partition for non-root, non-swap partitions.  Within the
 	    Label editor, create a single filesystem by typing
 	    <userinput>C</userinput>.  When prompted if this will be a FS
 	    (filesystem) or swap, choose <literal>FS</literal> and type in a
 	    mount point (e.g, <filename>/mnt</filename>).  When adding a
-	    disk in post-install mode, <application>sysinstall</application>
+	    disk in post-install mode, <application>Sysinstall</application>
 	    will not create entries
 	    in <filename>/etc/fstab</filename> for you, so the mount point
 	    you specify is not important.</para>
@@ -245,9 +245,9 @@
 	  <para>You are now ready to write the new label to the disk and
 	    create a filesystem on it.  Do this by typing
 	    <userinput>W</userinput>.  Ignore any errors from 
-	    <application>sysinstall</application> that
+	    <application>Sysinstall</application> that
 	    it could not mount the new partition.  Exit the Label Editor
-	    and <application>sysinstall</application> completely.</para>
+	    and <application>Sysinstall</application> completely.</para>
 	</step>
 
 	<step>
--- diff2 ends here ---

--- diff3 begins here ---
diff -ruN handbook.org/l10n/chapter.sgml handbook/l10n/chapter.sgml
--- handbook.org/l10n/chapter.sgml	Wed Mar 27 02:16:54 2002
+++ handbook/l10n/chapter.sgml	Sat May 25 12:10:15 2002
@@ -470,7 +470,7 @@
       <para>Also be sure to set the correct keymap and screenmap for your
 	single C chars character set through
 	<filename>/stand/sysinstall</filename>.
-	Once inside sysinstall, choose <literal>Configure</literal>, then
+	Once inside <application>Sysinstall</application>, choose <literal>Configure</literal>, then
 	<literal>Console</literal>.  Alternatively, you can add the
 	following to <filename>/etc/rc.conf</filename>:</para>
 
--- diff3 ends here ---

--- diff4 begins here ---
diff -ruN handbook.org/ports/chapter.sgml handbook/ports/chapter.sgml
--- handbook.org/ports/chapter.sgml	Sat May  4 17:20:00 2002
+++ handbook/ports/chapter.sgml	Sat May 25 12:10:44 2002
@@ -459,7 +459,7 @@
 	<title>Sysinstall Method</title>
 
 	<para>This method involves using
-	  <application>sysinstall</application> again to manually
+	  <application>Sysinstall</application> again to manually
 	  install the ports collection.</para>
 
 	<step>
@@ -495,7 +495,7 @@
 	</step>
 
 	<step>
-	  <para>Follow the menus to exit <application>sysinstall</application>.</para>
+	  <para>Follow the menus to exit <application>Sysinstall</application>.</para>
 	</step>
       </procedure>
 
--- diff4 ends here ---

--- diff5 begins here ---
diff -ruN handbook.org/security/chapter.sgml handbook/security/chapter.sgml
--- handbook.org/security/chapter.sgml	Wed May 22 10:01:01 2002
+++ handbook/security/chapter.sgml	Sat May 25 12:11:18 2002
@@ -1430,7 +1430,7 @@
       </indexterm>
       <para>Kerberos is an optional component of FreeBSD.  The easiest
         way to install this software is by selecting the 'krb4' or
-        'krb5' distribution in <application>sysinstall</application>
+        'krb5' distribution in <application>Sysinstall</application>
         during the initial installation of FreeBSD.  This will install
         the 'eBones' (KerberosIV) or 'Heimdal' (Kerberos5)
         implementation of Kerberos.  These implementations are
--- diff5 ends here ---


>Release-Note:
>Audit-Trail:

From: Ceri Davies <setantae@submonkey.net>
To: Marc Fonvieille <marc@blackend.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sat, 25 May 2002 13:42:48 +0100

 On Sat, May 25, 2002 at 01:27:13PM +0200, Marc Fonvieille wrote:
 > 	
 > >Description:
 > After my previous PR i did a search in the Handbook for sysinstall, and
 > i found several instances without application tags and/or using 
 > sysinstall instead of Sysinstall. Read the patches below for more 
 > details.
 
 > -        <para>DHCP is supported by <application>sysinstall</application>.
 > -          When configuring a network interface within sysinstall, 
 > +        <para>DHCP is supported by <application>Sysinstall</application>.
 > +          When configuring a network interface within <application>Sysinstall</application>, 
 
 As I mentioned in the other PR, I wouldn't be happy with capitalising
 "sysintall", although I am open to opinion.
 
 Of course, it should be marked up as an <application>.
 
 Ceri
 
 -- 
 get the cool shoe shine

From: Marc Fonvieille <marc@blackend.org>
To: Ceri Davies <setantae@submonkey.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sat, 25 May 2002 15:00:25 +0200

 On Sat, May 25, 2002 at 01:42:48PM +0100, Ceri Davies wrote:
 > As I mentioned in the other PR, I wouldn't be happy with capitalising
 > "sysintall", although I am open to opinion.
 >
 Ok, however in *80%* of installation chapter we have 
 <application>Sysinstall</application>, which must to fixed then.
 
 I took the caps as a convention cause when we talk about the command we
 use /stand/sysinstall and not sysinstall, same for
 <application>FDisk</application> etc...
 
 > Of course, it should be marked up as an <application>.
 >
 ok, let me know if i have to redo the patches, i have time.
 
 Marc

From: Ceri Davies <setantae@submonkey.net>
To: Marc Fonvieille <marc@blackend.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sat, 25 May 2002 14:59:32 +0100

 On Sat, May 25, 2002 at 03:00:25PM +0200, Marc Fonvieille wrote:
 > On Sat, May 25, 2002 at 01:42:48PM +0100, Ceri Davies wrote:
 > > As I mentioned in the other PR, I wouldn't be happy with capitalising
 > > "sysintall", although I am open to opinion.
 > >
 > Ok, however in *80%* of installation chapter we have 
 > <application>Sysinstall</application>, which must to fixed then.
 > 
 > I took the caps as a convention cause when we talk about the command we
 > use /stand/sysinstall and not sysinstall, same for
 > <application>FDisk</application> etc...
 
 I do utterly understand your reasoning, but with the work that has been done
 in the manpages to do the opposite in mind, I do think we should avoid using
 uppercase names in these situations.
 
 > > Of course, it should be marked up as an <application>.
 > >
 > ok, let me know if i have to redo the patches, i have time.
 
 It's probably worth waiting for a few more voices to be heard on this; I
 could well be in the minority here.
 
 Either way, I want to make clear that your work is very much appreciated.
 
 Thanks,
 
 Ceri
 
 -- 
 get the cool shoe shine

From: Giorgos Keramidas <keramida@FreeBSD.ORG>
To: Marc Fonvieille <marc@blackend.org>
Cc: bug-followup@FreeBSD.ORG
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sat, 25 May 2002 23:10:18 +0300

 On 2002-05-25 06:10, Marc Fonvieille wrote:
 > On Sat, May 25, 2002 at 01:42:48PM +0100, Ceri Davies wrote:
 > > As I mentioned in the other PR, I wouldn't be happy with capitalising
 > > "sysintall", although I am open to opinion.
 >
 > Ok, however in *80%* of installation chapter we have
 > <application>Sysinstall</application>, which must to fixed then.
 
 True.  It is not consistently marked up in all the docs.
 
 > I took the caps as a convention cause when we talk about the command
 > we use /stand/sysinstall and not sysinstall, same for
 > <application>FDisk</application> etc...
 
 I am very certain that ``FDisk'' or ``fDisk'' or whatever else one can
 come up with is the wrong way to refer to &man.fdisk.8;.
 
 :-)
 
 -- 
 Giorgos Keramidas    - http://www.FreeBSD.org
 keramida@FreeBSD.org - The Power to Serve

From: Giorgos Keramidas <keramida@FreeBSD.ORG>
To: Jay <jayed@jayed.com>
Cc: bug-followup@FreeBSD.ORG
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sat, 25 May 2002 23:14:32 +0300

 On 2002-05-25 14:08, Jay wrote:
 > And, in fact, if I use 'sysinstall' at the beginning of a sentence,
 > I still wouldn't capitalize it.  I guess I'm too case-sensitive. :p
 
 As ceri@freebsd.org (Ceri Davies) has already mentioned, the preferred
 way is to reword parts of the sentence, as charnier@freebsd.org
 (Philippe Charnier) has been doing for a lot of the manpages until
 now.  That is, instead of starting a sentence with the name of a
 program capitalized, as in:
 
 	.Nm Ls
 	will do ...
 
 He changes the text, to read:
 
 	The
 	.Nm
 	utility will do ...
 
 Which avoids the problem of starting the sentence
 with the capitalized name :-)
 
 - Giorgos
 

From: Marc Fonvieille <marc@blackend.org>
To: Giorgos Keramidas <keramida@FreeBSD.ORG>
Cc: bug-followup@FreeBSD.ORG
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sat, 25 May 2002 22:39:20 +0200

 On Sat, May 25, 2002 at 11:10:18PM +0300, Giorgos Keramidas wrote:
 > > I took the caps as a convention cause when we talk about the command
 > > we use /stand/sysinstall and not sysinstall, same for
 > > <application>FDisk</application> etc...
 > 
 > I am very certain that ``FDisk'' or ``fDisk'' or whatever else one can
 > come up with is the wrong way to refer to &man.fdisk.8;.
 > 
 Of course.
 
 In reading more of these *things*, i think it comes from application
 like "Partition Magic" for which "P" and "M" are correct in the name
 of the application, and from the fact in section title all words start
 with an upper case. Maybe then people took the habit of having upper 
 case for application name.
 
 Marc

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Marc Fonvieille <marc@blackend.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sun, 26 May 2002 00:49:31 +0300

 On 2002-05-25 22:39, Marc Fonvieille wrote:
 > On Sat, May 25, 2002 at 11:10:18PM +0300, Giorgos Keramidas wrote:
 > > > I took the caps as a convention cause when we talk about the command
 > > > we use /stand/sysinstall and not sysinstall, same for
 > > > <application>FDisk</application> etc...
 > >
 > > I am very certain that ``FDisk'' or ``fDisk'' or whatever else one can
 > > come up with is the wrong way to refer to &man.fdisk.8;.
 >
 > Of course.
 >
 > In reading more of these *things*, i think it comes from application
 > like "Partition Magic" for which "P" and "M" are correct...
 
 This is my personal opinion, but I'd like the names of the &man.x.y;
 entities to be used to commonly refer to the applications when
 possible.  This way we don't need to worry about capitalization,
 spelling, or other minor issues :)
 
 - Giorgos

From: Marc Fonvieille <marc@blackend.org>
To: FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org
Cc:  
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sun, 26 May 2002 12:18:01 +0200

 --vkogqOf2sHV7VnPd
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hello,
 
 Here's my mega-patch according to community opinion. I need to find a 
 brave soul to work on it :)
 
 Some details:
 
 - in text sysinstall is without upper case and between application tags
 - fdisk is fdisk not FDisk etc...
 - use of disklabel instead of Disklabel in the text.
 - use of fips instead of FIPS.
 - Partition Magic is not changed, the commercial name is with uppercases
 - DEFRAG should be defrag.
 - Norton Disk Tools, Stacker, and DoubleSpace are apps, and so need
   application tags.
 
 Marc
 
 --vkogqOf2sHV7VnPd
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="handbook.diff"
 
 diff -ruN handbook.org/advanced-networking/chapter.sgml handbook/advanced-networking/chapter.sgml
 --- handbook.org/advanced-networking/chapter.sgml	Thu May 16 03:42:20 2002
 +++ handbook/advanced-networking/chapter.sgml	Sun May 26 11:59:55 2002
 @@ -3384,7 +3384,7 @@
            <primary><application>sysinstall</application></primary>
          </indexterm>
          <para>DHCP is supported by <application>sysinstall</application>.
 -          When configuring a network interface within sysinstall, 
 +          When configuring a network interface within <application>sysinstall</application>, 
            the first question asked is, "Do you want to try DHCP
            configuration of this interface?"  Answering affirmatively will
            execute <command>dhclient</command>, and if successful, will fill 
 diff -ruN handbook.org/install/chapter.sgml handbook/install/chapter.sgml
 --- handbook.org/install/chapter.sgml	Sun May 26 01:11:10 2002
 +++ handbook/install/chapter.sgml	Sun May 26 11:59:12 2002
 @@ -34,10 +34,10 @@
      <indexterm><primary>installation</primary></indexterm>
  
      <para>FreeBSD is provided with a text-based, easy to use installation
 -      program called <application>Sysinstall</application>.  This is the
 +      program called <application>sysinstall</application>.  This is the
        default installation program for FreeBSD, although vendors are free to
        provide their own installation suite if they wish.  This chapter
 -      describes how to use <application>Sysinstall</application> to install
 +      describes how to use <application>sysinstall</application> to install
        FreeBSD.</para>
  
      <para>After reading this chapter, you will know:</para>
 @@ -52,11 +52,11 @@
        </listitem>
  
        <listitem>
 -	<para>How to start <application>Sysinstall</application>.</para>
 +	<para>How to start <application>sysinstall</application>.</para>
        </listitem>
  
        <listitem>
 -	<para>The questions <application>Sysinstall</application> will ask
 +	<para>The questions <application>sysinstall</application> will ask
  	  you, what they mean, and how to answer them.</para>
        </listitem>
      </itemizedlist>
 @@ -1052,7 +1052,7 @@
  
  	  <para>Answer <keycap>Y</keycap> to save the parameters and the
  	    probing will start.  After displaying the probe results in white
 -	    on black text <application>Sysinstall</application> will start
 +	    on black text <application>sysinstall</application> will start
  	    and display its main menu 
  	    (<xref linkend="sysinstall-main">).</para>
  
 @@ -1193,10 +1193,10 @@
        divided into a number of menus and screens that you can use to
        configure and control the installation process.</para>
  
 -    <para>The <application>Sysinstall</application> menu system is controlled
 +    <para>The <application>sysinstall</application> menu system is controlled
        by the arrow keys, <keycap>Enter</keycap>, <keycap>Space</keycap>, and
        other keys.  A detailed description of these keys, and what they do, is
 -      contained in <application>Sysinstall's</application> usage 
 +      contained in <application>sysinstall</application>'s usage 
        information.</para>
  
      <para>To review this information, ensure that the
 @@ -1364,7 +1364,7 @@
      <title>Allocating Disk Space</title>
  
      <para>Your first task is to allocate disk space for FreeBSD, and label
 -      that space so that <application>Sysinstall</application> can prepare
 +      that space so that <application>sysinstall</application> can prepare
        it.  In order to do this you need to know how FreeBSD expects to find
        information on the disk.</para>
  
 @@ -1736,7 +1736,7 @@
  		meaning associated with it, although that is now gone.  To
  		this day, some tools may operate oddly if told to work on
  		partition <literal>d</literal>, so
 -		<application>Sysinstall</application> will not normally create
 +		<application>sysinstall</application> will not normally create
  		partition <literal>d</literal>.</entry>
  	    </row>
  	  </tbody>
 @@ -1930,18 +1930,18 @@
  
  
      <sect2 id="main-fdisk">
 -      <title>Creating Slices using FDisk</title>
 +      <title>Creating Slices Using Fdisk</title>
  
        <note>
  	<para>No changes you make at this point will be written to the disk.
  	  If you think you have made a mistake and want to start again you can
 -	  use the menus to exit <application>Sysinstall</application> and try
 +	  use the menus to exit <application>sysinstall</application> and try
  	  again.  If you get confused and can not see how to exit you can
  	  always turn your computer off.</para>
        </note>
  
        <para>After choosing to begin a standard installation in
 -	<application>Sysinstall</application> you will be shown this
 +	<application>sysinstall</application> you will be shown this
  	message:</para>
  
        <screen>                                 Message
 @@ -1964,7 +1964,7 @@
  	<devicename>ad0</devicename> and <devicename>ad2</devicename>.</para>
  
        <figure id="sysinstall-fdisk-drive1">
 -	<title>Select Drive for FDisk</title>
 +	<title>Select Drive For Fdisk</title>
  
  	<mediaobject>
  	  <imageobject>
 @@ -2007,10 +2007,10 @@
  
        <para>You should select the disk on which you want to install FreeBSD,
  	and then press &gui.ok;.
 -	<application>FDisk</application> will start, with a display similar to
 +	The utility <application>fdisk</application> will start, with a display similar to
  	that shown in <xref linkend="sysinstall-fdisk1">.</para>
  
 -      <para>The <application>FDisk</application> display is broken into three
 +      <para>The <application>fdisk</application> display is broken into three
  	sections.</para>
  
        <para>The first section, covering the first two lines of the display,
 @@ -2026,7 +2026,7 @@
  	slice, which may contain other drive letters for DOS / Windows.</para>
  
        <para>The third section shows the commands that are available in
 -	<application>FDisk</application>.</para>
 +	<application>fdisk</application>.</para>
  
        <figure id="sysinstall-fdisk1">
  	<title>Typical Fdisk Partitions Before Editing</title>
 @@ -2043,7 +2043,7 @@
  
        <para>If you want to use FreeBSD for the entire disk (which will delete
  	all the other data on this disk when you confirm that you want
 -	<application>Sysinstall</application> to continue later in the
 +	<application>sysinstall</application> to continue later in the
  	installation process) then you can press <keycap>A</keycap>, which
  	corresponds to the <guimenuitem>Use Entire Disk</guimenuitem> option.
  	The existing slices will be removed, and replaced with a small area
 @@ -2079,7 +2079,7 @@
        </figure>
  
        <para>When finished, press <keycap>Q</keycap>.  Your changes will be
 -	saved in <application>Sysinstall</application>, but will not yet be
 +	saved in <application>sysinstall</application>, but will not yet be
  	written to disk.</para>
      </sect2>
  
 @@ -2126,7 +2126,7 @@
  	Select Drives screen after the boot manager selection.  If you wish to
  	install FreeBSD on to more than one disk, then you can select another
  	disk here and repeat the slice process using
 -	<application>FDisk</application>.</para>
 +	<application>fdisk</application>.</para>
  
        <figure id="sysinstall-fdisk-drive2">
  	<title>Exit Select Drive</title>
 @@ -2150,7 +2150,7 @@
  
      <sect2 id="disklabeleditor">
        <title>Creating Partitions using
 -	<application>Disklabel</application></title>
 +	<application>disklabel</application></title>
        
        <para>You must now create some partitions inside each slice that you
  	have just created.  Remember that each partition is lettered, from
 @@ -2308,7 +2308,7 @@
  		partition on a slice is reserved for the filesystem that will
  		be the root (<filename>/</filename>) filesystem.  You do not
  		have to follow this convention, but
 -		<application>Sysinstall</application> does, so following it
 +		<application>sysinstall</application> does, so following it
  		yourself makes the installation slightly cleaner.  You can
  		choose to mount this filesystem anywhere; this example
  		suggests that you mount them as directories
 @@ -2321,7 +2321,7 @@
        </table>
  
        <para>Having chosen your partition layout you can now create it using
 -	<application>Sysinstall</application>.  You will see this
 +	<application>sysinstall</application>.  You will see this
  	message:</para>
  
        <screen>                                 Message
 @@ -2335,15 +2335,15 @@
                                  [  OK  ] </screen>
  
        <para>Press <keycap>Enter</keycap> to start the FreeBSD partition
 -	editor, called <application>Disklabel</application>.</para>
 +	editor, called <application>disklabel</application>.</para>
  
        <para><xref linkend="sysinstall-label"> shows the display when you first
 -	start <application>Disklabel</application>.  The display is divided in
 +	start <application>disklabel</application>.  The display is divided in
  	to three sections.</para>
  
        <para>The first few lines show the name of the disk you are currently
  	working on, and the slice that contains the partitions you are
 -	creating (at this point <application>Disklabel</application> calls
 +	creating (at this point <application>disklabel</application> calls
  	this the <literal>Partition name</literal> rather than slice name).
  	This display also shows the amount of free space within the slice;
  	that is, space that was set aside in the slice, but that has not yet
 @@ -2355,7 +2355,7 @@
  	filesystem.</para>
  
        <para>The bottom third of the screen shows the keystrokes that are valid
 -	in <application>Disklabel</application>.</para>
 +	in <application>disklabel</application>.</para>
  
        <figure id="sysinstall-label">
  	<title>Sysinstall Disklabel Editor</title>
 @@ -2367,7 +2367,7 @@
  	</mediaobject>
        </figure>
  
 -      <para><application>Disklabel</application> can automatically create
 +      <para>The utility <application>disklabel</application> can automatically create
  	partitions for you and assign them default sizes.  Try this now, by
  	Pressing <keycap>A</keycap>.  You will see a display similar to that
  	shown in <xref linkend="sysinstall-label2">.  Depending on the size of
 @@ -2454,7 +2454,7 @@
        </figure>
        
        <para>Finally, because you are creating a filesystem, you must tell
 -	<application>Disklabel</application> where the filesystem is to be
 +	<application>disklabel</application> where the filesystem is to be
  	mounted.  The dialog box is shown in 
  	<xref linkend="sysinstall-label-mount">.  The root filesystem's mount
  	point is <filename>/</filename>, so type <userinput>/</userinput>, and
 @@ -4660,23 +4660,23 @@
  	  <answer>
  	    <para>If your machine is already running MS-DOS and has little
  	      or no free space available for the FreeBSD installation, all
 -	      hope is not lost!  You may find the <application>FIPS</application>
 +	      hope is not lost!  You may find the <application>fips</application>
  	      utility, provided
  	      in the <filename>tools</filename> directory on the FreeBSD
  	      CDROM or various FreeBSD FTP sites to be quite
  	      useful.</para>
  
  	    <indexterm>
 -	      <primary><command>FIPS</command></primary>
 +	      <primary><command>fips</command></primary>
  	    </indexterm>
 -	    <para><application>FIPS</application> allows you to split an
 +	    <para>The utility <application>fips</application> allows you to split an
  	      existing MS-DOS partition into two pieces, preserving the
  	      original partition and allowing you to install onto the second
  	      free piece.  You first defragment your MS-DOS partition using
 -	      the Windows <application>DEFRAG</application> utility (go into
 +	      the Windows <application>defrag</application> utility (go into
  	      Explorer, right-click on the hard drive, and choose to defrag
 -	      your hard drive), or Norton Disk Tools. You then must run
 -	      <application>FIPS</application>.  It will prompt you for the
 +	      your hard drive), or <application>Norton Disk Tools</application>. You then must run
 +	      <application>fips</application>.  It will prompt you for the
  	      rest of the information it needs.  Afterwards, you can reboot
  	      and install FreeBSD on the new free slice.  See the
  	      <emphasis>Distributions</emphasis> menu for an estimate of how
 @@ -4690,10 +4690,10 @@
  	      from <ulink url="http://www.powerquest.com/">PowerQuest</ulink>
  	      called <application>Partition Magic</application>. This
  	      application has far more functionality than
 -	      <application>FIPS</application>, and is highly recommended if
 +	      <application>fips</application>, and is highly recommended if
  	      you plan to often add/remove operating systems (like me).
  	      However, it does cost money, and if you plan to install FreeBSD
 -	      once and then leave it there, <application>FIPS</application>
 +	      once and then leave it there, <application>fips</application>
  	      will probably be fine for you.</para>
  	  </answer>
  	</qandaentry>
 @@ -4706,8 +4706,8 @@
  
  	  <answer>
  	    <para>No.  If you are using a utility such as
 -	      <trademark class="trade">Stacker</trademark> or
 -	      <trademark class="trade">DoubleSpace</trademark>, FreeBSD
 +	      <trademark class="trade"><application>Stacker</application></trademark> or
 +	      <trademark class="trade"><application>DoubleSpace</application></trademark>, FreeBSD
  	      will only be able to use whatever portion of the filesystem
  	      you leave uncompressed.  The rest of the filesystem will
  	      show up as one large file (the stacked/double spaced file!).
 @@ -5001,7 +5001,7 @@
  
      <para>There may be some situations in which you need to create your own
        FreeBSD installation media and/or source.  This might be physical media,
 -      such as a tape, or a source that <application>Sysinstall</application>
 +      such as a tape, or a source that <application>sysinstall</application>
        can use to retrieve the files, such as a local FTP site, or an MS-DOS
        partition.  For example:</para>
  
 diff -ruN handbook.org/l10n/chapter.sgml handbook/l10n/chapter.sgml
 --- handbook.org/l10n/chapter.sgml	Wed Mar 27 02:16:54 2002
 +++ handbook/l10n/chapter.sgml	Sun May 26 12:00:51 2002
 @@ -470,7 +470,7 @@
        <para>Also be sure to set the correct keymap and screenmap for your
  	single C chars character set through
  	<filename>/stand/sysinstall</filename>.
 -	Once inside sysinstall, choose <literal>Configure</literal>, then
 +	Once inside <application>sysinstall</application>, choose <literal>Configure</literal>, then
  	<literal>Console</literal>.  Alternatively, you can add the
  	following to <filename>/etc/rc.conf</filename>:</para>
  
 diff -ruN handbook.org/ports/chapter.sgml handbook/ports/chapter.sgml
 --- handbook.org/ports/chapter.sgml	Sat May  4 17:20:00 2002
 +++ handbook/ports/chapter.sgml	Sun May 26 12:03:08 2002
 @@ -451,7 +451,7 @@
        </para>
  
        <para>When installing your FreeBSD system,
 -	<application>Sysinstall</application> asked if you would like to
 +	<application>sysinstall</application> asked if you would like to
  	install the ports collection.  If you chose no, you can follow
  	these instructions to obtain the ports collection.</para>
  
 
 --vkogqOf2sHV7VnPd--
Responsible-Changed-From-To: freebsd-doc->rpratt  
Responsible-Changed-By: rpratt 
Responsible-Changed-When: Tue May 28 01:40:35 PDT 2002 
Responsible-Changed-Why:  
I'll take this one since most are in a doc I wrote. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=38540 
Responsible-Changed-From-To: rpratt->blackend 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Thu Aug 26 02:56:28 GMT 2004 
Responsible-Changed-Why:  
With bugmeister hat on, reassign from inactive committer to submitter 
(who has been a doc committer for a long time). 

http://www.freebsd.org/cgi/query-pr.cgi?pr=38540 

From: "Siebrand Mazeland" <s.mazeland@xs4all.nl>
To: <freebsd-gnats-submit@FreeBSD.org>, <marc@blackend.org>
Cc:  
Subject: Re: docs/38540: sysinstall application name should be Sysinstall with right tags in all the Handbook
Date: Sun, 27 Feb 2005 14:29:59 +0100

 Checked out this patch. Found out that a lot had already been corrected and
 the some occurances had not been tagged consistently (especially within
 <title> tags). Also changed FreeBSD to &os; for involved chapters (disks,
 install, l10n, ports).
 
 Updated patch (build tested) can be found at:
 http://nitro.dk/~siebrand/handbook.patch
 
State-Changed-From-To: open->closed 
State-Changed-By: gabor 
State-Changed-When: Wed May 28 00:16:14 UTC 2008 
State-Changed-Why:  
This issue has been corrected since then, let's close this PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=38540 
>Unformatted:
