[PATCH v2 0/9] intro.3, libc.7, ldconfig.8: Revise

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Alex,

v2:

* No longer migrates `PP` macros to `P`.
* No longer migrates ASCII "arrow" `->` to troff special character.
* Changes to each page split into markup, style, and content changes.

For reference, this trichotomy is one that evolved for me over the past
5-6 years while working on groff man pages.  Here is how I define them,
for reference.

+ Markup changes affect "only" the document source and are not visible
  in formatted output.  There is some imprecision in this category; I
  would regard a change to word breakpoints or hyphenation as a "markup"
  fix even though these _might_ be visible in the output depending on
  the line length of the output device (which, for terminals, is highly
  flexible).  Alterations to indentation would probably also qualify.

+ Style changes are a broad category encompassing corrections to
  spelling and grammar in natural language, but also things like
  typeface changes or changes to the style of a source code example.

+ Content changes significantly alter the informational substance of the
  page.  These include corrections to matters of fact or exposure of
  previously undocumented information.

Regards,
Branden

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux