From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-1.sys.kth.se (smtp-1.sys.kth.se [130.237.32.175]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id oATH1PUc016039 for ; Mon, 29 Nov 2010 12:01:25 -0500 (EST) Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 3A78F15794B; Mon, 29 Nov 2010 18:01:19 +0100 (CET) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-1.sys.kth.se ([130.237.32.175]) by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) (amavisd-new, port 10024) with LMTP id ciKclQuvbN5C; Mon, 29 Nov 2010 18:01:17 +0100 (CET) X-KTH-Auth: kristaps [193.10.49.5] X-KTH-mail-from: kristaps@bsd.lv Received: from [172.16.18.84] (unknown [193.10.49.5]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 8E9E915791A; Mon, 29 Nov 2010 18:01:16 +0100 (CET) Message-ID: <4CF3DC5C.1040207@bsd.lv> Date: Mon, 29 Nov 2010 18:01:16 +0100 From: Kristaps Dzonsons User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.15) Gecko/20101030 Icedove/3.0.10 X-Mailinglist: mdocml-tech Reply-To: tech@mdocml.bsd.lv MIME-Version: 1.0 To: tech@mdocml.bsd.lv CC: Ingo Schwarze , jmc@openbsd.org Subject: Re: Where to put mandoc roff documentation? References: <20101127184503.GA27534@iris.usta.de> <20101127211832.GA27550@kerhand.co.uk> <20101127214631.GC27534@iris.usta.de> <20101128152330.GA23201@iris.usta.de> In-Reply-To: <20101128152330.GA23201@iris.usta.de> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit > 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