On Apr 01 09:24:22, keybou...@gmail.com wrote:
> In the past, I attempted to write stuff with man page macros.
> I could not find any actual docs on the macros or how to use them.
> I found that there was no consistent style or rules
> from reverse engineering the shipped system man pages.
Whether
> On Apr 01 14:24:42, rai...@macports.org wrote:
> > Many open source projects generate their man pages from a high-level
> > markup language. I am only aware of the various *BSD systems that keep
> > writing roff directly.
Just to clarify:
* no-one is advocating "writing roff directly".
* mdoc(7
On Apr 01 14:24:42, rai...@macports.org wrote:
> > I'm not hoping to change the course here,
> > but what were the manpages written in before this?
> > porthier.7 is in mdoc(7), with .Dd June 1, 2007
> > - were all the base manpages im mdoc(7) before?
>
> Back when the NewHelpSystem [1] was starte
My ... (if 2 bits is 25 cents, then 0.2 bits is 2.5 cents, ... ok, call it
inflation) 0.2 bits on this subject:
In the past, I attempted to write stuff with man page macros. I could not find
any actual docs on the macros or how to use them.
I found that there was no consistent style or rules fr
On 2017-04-01 10:28, Jan Stary wrote:
> But the age of the asciidoc rewrite has nothing to do with it, right?
>
> I'm not hoping to change the course here,
> but what were the manpages written in before this?
> porthier.7 is in mdoc(7), with .Dd June 1, 2007
> - were all the base manpages im mdoc(
On Mar 31 23:07:06, ryandes...@macports.org wrote:
> > Anyway, the mdoc(7) rewrite is apparently not happening.
>
> Right; the asciidoc rewrite of the manpages was just released to the public
> in MacPorts 2.4 so there's probably no interest in changing it again so soon.
But the age of the ascii
On Mar 30, 2017, at 15:11, Jan Stary wrote:
> On Mar 30 21:47:38, rai...@macports.org wrote:
>> On 03/30/2017 09:26 PM, Jan Stary wrote:
>>> Just forget it. My intentions when proposing the mdoc(7) rewrite
>>> were the opposite of having asciidoc and docbook and xml/xsl ...
>>
>> While the depen
On Mar 30 21:47:38, rai...@macports.org wrote:
> On 03/30/2017 09:26 PM, Jan Stary wrote:
> > Just forget it. My intentions when proposing the mdoc(7) rewrite
> > were the opposite of having asciidoc and docbook and xml/xsl ...
>
> While the dependencies seem quite heavy,
(to say the least)
> la
On 03/30/2017 09:26 PM, Jan Stary wrote:
> Just forget it. My intentions when proposing the mdoc(7) rewrite
> were the opposite of having asciidoc and docbook and xml/xsl ...
While the dependencies seem quite heavy, languages like man(7)/mdoc(7) just fell
out of fashion and rarely anyone still und
On Mar 30 19:08:44, h...@stare.cz wrote:
> I propose to rewrite them into the _semantic_ markup of mdoc(7) language.
On Mar 30 20:59:31, rai...@macports.org wrote:
> Our man pages are actually written in AsciiDoc and then converted to the roff
> output. We only maintain the generated roff output i
Hey,
On Thu, Mar 30, 2017 at 07:08:44PM +0200, Jan Stary wrote:
> Currently, the port-* manpages are written using the legacy man(7)
> language which uses low-level roff constructs to described
> presentational details.
>
> I propose to rewrite them into the _semantic_ markup of mdoc(7)
> languag
On 03/30/2017 07:08 PM, Jan Stary wrote:
> Currently, the port-* manpages are written
> using the legacy man(7) language which uses
> low-level roff constructs to described presentational details.
>
> I propose to rewrite them into the _semantic_ markup of mdoc(7) language.
> Both have been around
Err, the intended subject was "manpages in mdoc(7)" :-)
But yes, manpages is mdoc(7), imho.
On Mar 30 19:08:44, h...@stare.cz wrote:
> Currently, the port-* manpages are written
> using the legacy man(7) language which uses
> low-level roff constructs to described presentatio
Currently, the port-* manpages are written
using the legacy man(7) language which uses
low-level roff constructs to described presentational details.
I propose to rewrite them into the _semantic_ markup of mdoc(7) language.
Both have been around for decades and are well supported by groff.
As an
14 matches
Mail list logo
