Bug 38880

Summary: Typo fixes in doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
Product: Documentation Reporter: Chris Pepper <pepper>
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 Chris Pepper 2002-06-04 04:10:01 UTC 
	Clean up some typos.
	Fix some odd quote tags -- they appeared to work, but were confusing, e.g., "<quote/make world/"
	put 'make' into an entity.

Fix: Proposed patch follows.
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 02:04:05 UTC 
On 2002-06-03 23:09 -0400, Chris Pepper wrote:
> -	<filename>/var/tmp/root</filename> have a leading <quote/./.  At the
> +	<filename>/var/tmp/root</filename> have a leading <quote>.</quote>.  At the

This is not really a typo.  It's valid SGML, AFAIK.
What do you all others think?  Is this (and similar parts of the
patch) worth the change?

> -	      just those things that have changed, and are confident you can
> +	      just those things that have changed, and be confident you can

Good catch :)

> -	    <para>If you want to live dangerously then make the world, passing
> -	      the <makevar>NOCLEAN</makevar> definition to <command>make</command>, like
> +	    <para>If you want to live dangerously then <command>make</command> the world, passing
> +	      the <makevar>NOCLEAN</makevar> option to the <command>make</command>, like
>  	      this:</para>

I am almost convinced that this part can be deleted.  We don't want
the users to live dangerously.  IMHO, those that can live dangerously
and still get away with it, won't need the Handbook to tell them what
needs to be done.

> -		<para>Pass the <option>-j&lt;n&gt;</option> option to make to
> +		<para>Pass the <option>-j&lt;n&gt;</option> option to &man.make.1; to

I'd probably use <command>make</command> but this is OK too, I guess.

Giorgos.
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-23 22:13:51 UTC 
State Changed
From-To: open->closed

The changes have been committed, thanks :) 
I just removed the living dangerously part. 
We need a way to describe all the make options in one place. 
Having options scattered around the docs is not quite right, 
and I don't like the 'dangerously' part of it too much.
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-23 22:13:51 UTC 
Responsible Changed
From-To: freebsd-doc->keramida