Bug 38851

Summary: Some keycap tags addition and minor changes in section 3.8 of the Handbook
Product: Documentation Reporter: Marc Fonvieille <marc>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
chapter.sgml.diff none

Description Marc Fonvieille 2002-06-03 12:00:11 UTC 
Some keycap tags addition and minor changes in section 3.8 of the
Handbook. Read the patch below for more details.

Fix: Apply the patch to handbook/basics/chapter.sgml
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-04 19:03:54 UTC 
On 2002-06-03 12:50 +0200, Marc Fonvieille wrote:
> @@ -1256,9 +1256,9 @@

[Snippetry of patch part that looks nice.]

> @@ -1277,7 +1277,7 @@
>        <secondary><command>emacs</command></secondary>
>      </indexterm>
>      <para>FreeBSD also comes with more powerful text editors such as
> -      <command>vi</command> as part of the base system, and
> +      <command>vi</command> as part of the base system, 
>        <command>emacs</command> and <command>vim</command>
>        as part of the FreeBSD Ports Collection.  These editors offer much
>        more functionality and power at the expense of being a little more
> --- chapter.sgml.diff ends here ---

The new line that is added has whitespace at EOL.  This is not really
important though.  What is more important is that we'll probably have to
rewrite parts of the sentence anyways.  What about something like this?

%%%
@@ -1277,9 +1277,9 @@
       <secondary><command>emacs</command></secondary>
     </indexterm>
     <para>FreeBSD also comes with more powerful text editors such as
-      <command>vi</command> as part of the base system, and
-      <command>emacs</command> and <command>vim</command>
-      as part of the FreeBSD Ports Collection.  These editors offer much
+      <command>vi</command> as part of the base system, while other editors, like
+      <command>emacs</command> and <command>vim</command>,
+      are part of the FreeBSD Ports Collection.  These editors offer much
       more functionality and power at the expense of being a little more
       complicated to learn.  However if you plan on doing a lot of text
       editing, learning a more powerful editor such as
%%%

- Giorgos
Comment 2 Marc Fonvieille 2002-06-04 19:46:31 UTC 
On Tue, Jun 04, 2002 at 09:03:54PM +0300, Giorgos Keramidas wrote:
> The new line that is added has whitespace at EOL.  This is not really
> important though.

Oh i missed it :(

> What is more important is that we'll probably have to
> rewrite parts of the sentence anyways.  What about something like this?
> 
> %%%
> @@ -1277,9 +1277,9 @@
>        <secondary><command>emacs</command></secondary>
>      </indexterm>
>      <para>FreeBSD also comes with more powerful text editors such as
> -      <command>vi</command> as part of the base system, and
> -      <command>emacs</command> and <command>vim</command>
> -      as part of the FreeBSD Ports Collection.  These editors offer much
> +      <command>vi</command> as part of the base system, while other editors, like
> +      <command>emacs</command> and <command>vim</command>,
> +      are part of the FreeBSD Ports Collection.  These editors offer much
>        more functionality and power at the expense of being a little more
>        complicated to learn.  However if you plan on doing a lot of text
>        editing, learning a more powerful editor such as
> %%%
> 

It's perfect, far better than my *quick* fix.

Marc
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 01:47:44 UTC 
State Changed
From-To: open->closed

The changes have been committed.  I merged the changes mentioned in 
the audit trail of the PR, so this should be fine now. 

Thanks for the work in this part of the documentation ;)
Comment 4 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 01:47:44 UTC 
Responsible Changed
From-To: freebsd-doc->keramida