[9fans] formatting the manual from plan9 ports?

[9fans] formatting the manual from plan9 ports?

[Aharon Robbins]

Is there a simple recipe to use p9p troff to format the manual pages
from the plan 9 dist?  I.e.:

	Install Plan 9 Ports
	wget plan9.iso from bell labs
	mount said iso /some/where
	9 rc
	cd /some/where/sys/man
	# magic stuff here

(Or tar off the dist to regular files where things are writable.)

Thanks!

Arnold

Re: [9fans] formatting the manual from plan9 ports?

[pmarin]

See the example in tr2post(1)

On Thu, May 24, 2012 at 9:03 PM, Aharon Robbins <arnold@skeeve.com> wrote:
> Is there a simple recipe to use p9p troff to format the manual pages
> from the plan 9 dist?  I.e.:
>
>        Install Plan 9 Ports
>        wget plan9.iso from bell labs
>        mount said iso /some/where
>        9 rc
>        cd /some/where/sys/man
>        # magic stuff here
>
> (Or tar off the dist to regular files where things are writable.)
>
> Thanks!
>
> Arnold
>

Re: [9fans] formatting the manual from plan9 ports?

[Aharon Robbins]

Hi.

Thanks. I did see that. I was wondering more about all the hardcoded
path names in the various scripts in /sys/man and /sys/lib/man and
also getting p9p mk to use rc instead of sh to run commands.

I suppose that I will just manually "nerd through it" (as a friend
used to say).

Thanks,

Arnold

> From: pmarin <pmarin.mail@gmail.com>
> Date: Fri, 25 May 2012 21:08:18 +0200
> To: Fans of the OS Plan 9 from Bell Labs <9fans@9fans.net>
> Subject: Re: [9fans] formatting the manual from plan9 ports?
>
> See the example in tr2post(1)
>
> On Thu, May 24, 2012 at 9:03 PM, Aharon Robbins <arnold@skeeve.com> wrote:
> > Is there a simple recipe to use p9p troff to format the manual pages
> > from the plan 9 dist? ??I.e.:
> >
> > ?? ?? ?? ??Install Plan 9 Ports
> > ?? ?? ?? ??wget plan9.iso from bell labs
> > ?? ?? ?? ??mount said iso /some/where
> > ?? ?? ?? ??9 rc
> > ?? ?? ?? ??cd /some/where/sys/man
> > ?? ?? ?? ??# magic stuff here
> >
> > (Or tar off the dist to regular files where things are writable.)
> >
> > Thanks!
> >
> > Arnold

Re: [9fans] formatting the manual from plan9 ports?

[erik quanstrom]

On Tue May 29 17:03:49 EDT 2012, arnold@skeeve.com wrote:
> Hi.
>
> Thanks. I did see that. I was wondering more about all the hardcoded
> path names in the various scripts in /sys/man and /sys/lib/man and
> also getting p9p mk to use rc instead of sh to run commands.
>
> I suppose that I will just manually "nerd through it" (as a friend
> used to say).

why don't you just put the files where the script expects, either
by making /sys for real and putting the files there, or mount --bind'ing?

- erik

Re: [9fans] formatting the manual from plan9 ports?

[cinap_lenrek]

short hardcoded paths are an advantage. this is not linux. this
is plan9. there are rules. the kernel already provides a way for
indirection that works for *everything*. mount/bind and private
namespaces.

no need to reimplement indirection in every program over and
over again.

a hardcoded path expresses an intent. you can look at it and you
know what it expects because ususly the stuff it points to is
already there or has an established meaning. (read namespace(4))

this is better than enviroment variables like $FOOBARBAZPATH
because it hides the default somewhere in the program, or it will
just fail when not specified giving me no clue what $FOOBARBAZPATH
is supposed to be. theres also complexity involved in the
implementatoin. using a hardcoded paths is great. you just let
the program fail with sysfatal("%r"); and it will show the path
it tired to open in the error message giving immidiate clue what
it needs.

--
cinap

Re: [9fans] formatting the manual from plan9 ports?

[erik quanstrom]

On Tue May 29 23:48:31 EDT 2012, cinap_lenrek@gmx.de wrote:
> short hardcoded paths are an advantage. this is not linux. this
> is plan9. there are rules. the kernel already provides a way for
> indirection that works for *everything*. mount/bind and private
> namespaces.

while this is all true, and i agree with you, the problem at hand it
to get things formatted on linux.

- erik

Re: [9fans] formatting the manual from plan9 ports?

[erik quanstrom]

> Thanks to everyone for the advice.
>
> > On Tue May 29 23:48:31 EDT 2012, cinap_lenrek@gmx.de wrote:
> > > short hardcoded paths are an advantage. this is not linux. this
> > > is plan9. there are rules. the kernel already provides a way for
> > > indirection that works for *everything*. mount/bind and private
> > > namespaces.
> >
> > while this is all true, and i agree with you, the problem at hand it
> > to get things formatted on linux.
>
> Right. The problem is that Linux already has a /sys directory. Who knows
> what would break if I mount over that.

you won't know if you don't try.  :-)  chroot yourself or something.

or, you can do it in the source pretty easily.  awk is the perfect tool
for the job.  :-)  you could change every /sys/... to /9/sys/...

- erik

Re: [9fans] formatting the manual from plan9 ports?

[arnold]

Thanks to everyone for the advice.

> On Tue May 29 23:48:31 EDT 2012, cinap_lenrek@gmx.de wrote:
> > short hardcoded paths are an advantage. this is not linux. this
> > is plan9. there are rules. the kernel already provides a way for
> > indirection that works for *everything*. mount/bind and private
> > namespaces.
>
> while this is all true, and i agree with you, the problem at hand it
> to get things formatted on linux.

Right. The problem is that Linux already has a /sys directory. Who knows
what would break if I mount over that.

Thanks,

Arnold