Re: Where to put mandoc roff documentation?

[Kristaps Dzonsons <kristaps@bsd.lv>]

> replying to myself in order to hold my promise:
>
> Ingo Schwarze wrote on Sat, Nov 27, 2010 at 10:46:31PM +0100:
>
>> Good, so i shall soon move roff.7 to share/man/man7
>
> Done.
>
>> and start polishing it such that we can install it
>> once we feel it is ripe.
>
> Do you think the patch below is sufficient to get it ready
> for installing it?
>
> Changes:
>   - Change the one-line description to
>       "roff language reference for mandoc"
>     because what we have is really too presumptuous.
>   - A bit more motivation in the DESCRIPTION.
>   - Point to mandoc_char(7) below LANGUAGE SYNTAX.
>   - Change MACRO SYNTAX to REQUEST SYNTAX.
>     In roff, the little things after the initial dot that are built-in
>     to the language have always been called "requests".
>     In roff, "macros" are only those things defined by the user
>     or by macro packages.
>     In the same spirit, avoid the repetitive term "user-defined macro",
>     but keep "user-defined string", as there are also predefined strings.
>   - Describe request syntax more systematically.
>     This also allows to remove the remark that arguments are
>     delimited by whitespace at one or two other places.
>   - Remove bogus backslashes from an `.if' example.
>     No idea how they got there.
>     I tested that the code works without the backslashes.
>   - The braces supported by conditional requests are not macros,
>     but escape sequences.
>   - Make the documentation of the nS register a bit more precise.
>   - Referring to doc.tmac makes no sense in roff(7).
>   - Add SEE ALSO and HISTORY.
>
> [...]
>> Once we will be installing it, we can then start moving class 1
>> stuff there.
>
> That's still for the future.

Ingo and Jason,

I, for one, have no issues with these changes.  Feel free to commit them 
into BSD.lv.

Thanks!

Kristaps
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv