Bug 114272

Summary: minor grammar fixes and more to handbook/ports chapter
Product: Documentation Reporter: minimarmot <minimarmot>
Component: Books & ArticlesAssignee: Marc Fonvieille <blackend>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description minimarmot 2007-07-04 00:30:03 UTC 
I attach a patch (chapter.sgml.diff.txt) with many minor corrections to the ``ports'' handbook chapter, which I will detail here (not necessarily in order).

o s/third party/third-party/g

o s/Pentium IV/Pentium 4/  (preferred in at least one place on Intel's website

o s/compile time/compile/time/g (a priori not a global change, but I checked)

o PACKAGESITE: was used before defined as an environment variable, then defined as an environment variable.  Move clarification to first usage

o add a note that pkg_delete requires name and version (I forget this a lot).  Please review the markup; I'm not sure that <literal> is the best tag for that text

o add reference to sha256 as well as md5, and change the wording a bit to make clear that the checksums are not built, but included in distinfo.  I suppose that the md5 and sha256 man pages are the same, so perhaps they both don't need to be mentioned, but md5 is not the only hash used for this purpose

Fix: patch attached

Patch attached with submission follows:
How-To-Repeat: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports.html
and the rest of the chapter
Comment 1 Marc Fonvieille freebsd_committer freebsd_triage 2007-07-04 09:56:58 UTC 
> o s/compile time/compile/time/g (a priori not a global change, but I checked)
>
[...]

For this one, what is the en_US usage "compile time" or "compile-time"?
I cannot find a reliable reference.

-- 
Marc
Comment 2 minimarmot 2007-07-04 15:37:46 UTC 
>
> For this one, what is the en_US usage "compile time" or "compile-time"?
> I cannot find a reliable reference.
>
> --
> Marc
>

Hmmm. . .my degrees are not in English, but a bit of thought seems to
indicate that when used as a compound adjective (compile-time
behaviour), it should be hyphenated.  There seem to be at least two
other ways in which this string can appear, such as: "X verbs Y at
compile time" and "my compile time is very long".
The latter definitely is not hyphenated, but I'm not sure yet about the other.

All the appearances in the submitted patch seem to be pretty clearly
(to me, at least. . .) instances of compound adjectives --
compile-time options are the options which are set at the time of
compilation, so compile-time is a compound adjective.

-Ben Kaduk
Comment 3 Marc Fonvieille freebsd_committer freebsd_triage 2007-07-05 06:55:21 UTC 
Responsible Changed
From-To: freebsd-doc->blackend

I'll take care of this one.
Comment 4 dfilter service freebsd_committer freebsd_triage 2007-07-06 09:00:14 UTC 
blackend    2007-07-06 07:59:56 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/ports chapter.sgml 
  Log:
  - Add hyphens where needed (for example s/third party/third-party/);
  - s/Pentium IV/Pentium 4 to match Intel syntax;
  - Some rewordings for clarification of some points;
  - Add reference to sha256(1).
  
  PR:             docs/114272
  Submitted by:   Ben Kaduk <minimarmot@gmail.com>
  
  Revision  Changes    Path
  1.264     +22 -14    doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 5 Marc Fonvieille freebsd_committer freebsd_triage 2007-07-06 09:00:22 UTC 
State Changed
From-To: open->closed

Committed, thanks.