Saturday, January 14, 2023

Re: old UNIX documentation

On Sat, Jan 14, 2023 at 11:46:54PM +0100, Jan Stary wrote:
> On Sep 13 07:04:55, jmc@kerhand.co.uk wrote:
> > > Long ago and far away, the Berkeley distributions used to ship an
> > > assortment of system documentation in /usr/share/doc, including a
> > > general-purpose system administrators manual.
> > >
> > > I guess people didn't want to update those, or maybe thought they
> > > were sacred relics, never to be touched. But all the *BSDs dropped
> > > them, years ago. I thought that was the wrong move; they should
> > > have been kept, along with a /usr/share/doc/README that noted they
> > > are historical, and therefore probably out of date. Although I'm
> > > sure the vi documentation stands up to this day.
> > >
> >
> > we stopped installing them because many of them were falling out of date
> > and there wasn;t really the resources (or motivation) to update them.
> > however not all of them were removed. although no longer installed, some
> > of the better ones remain in the source tree. from a quick look:
>
> Some of them are still quite nice to read!
>

yes. the ones left were the ones that people felt still had relevance
and were in better condition.

> > /usr/src/usr.bin/gprof/PSD.doc
> > /usr/src/usr.bin/lex/PSD.doc
> > /usr/src/usr.bin/m4/PSD.doc
> > /usr/src/usr.bin/make/PSD.doc
> > /usr/src/usr.bin/yacc/PSD.doc
> > /usr/src/bin/csh/USD.doc
> > /usr/src/bin/ed/USD.doc
> > /usr/src/games/trek/USD.doc
> > /usr/src/usr.bin/awk/USD.doc
> > /usr/src/usr.bin/bc/USD.doc
>
>
> Index: usr.bin/bc//USD.doc/bc
> ===================================================================
> RCS file: /cvs/src/usr.bin/bc/USD.doc/bc,v
> retrieving revision 1.9
> diff -u -p -r1.9 bc
> --- usr.bin/bc//USD.doc/bc 9 Jul 2004 10:23:05 -0000 1.9
> +++ usr.bin/bc//USD.doc/bc 14 Jan 2023 22:41:09 -0000
> @@ -1029,7 +1029,7 @@ to the named expression on the left.
> .PP
> The result of the above expressions is equivalent
> to ``named expression = named expression OP expression'',
> -where OP is the operator after the = sign.
> +where OP is the operator before the = sign.
> .NH 1
> Relations
> .PP
>

fixed, thanks.

jmc

No comments:

Post a Comment