Re: RFC: removal of share/doc/{papers,psd,smm,usd} in 2 months

On 22-10-2012 14:53, C. P. Ghost wrote:
> On Sun, Oct 21, 2012 at 11:53 AM, Ulrich Spörlein <uqs_at_freebsd.org> wrote:
> > On Sun, 2012-10-21 at 10:40:45 +0200, Hans Ottevanger wrote:
> >> On 10/19/12 16:36, Ulrich Spörlein wrote:
> >> > Hi all,
> >> >
> >> > those roff sources have been very naughty and will be removed from the
> >> > tree by the end of the year. Most of those papers are severely out of
> >> > date and provide no more use to the system. They can probably also be
> >> > found online using a search engine of your choice.
> >> >
> >>
> >> Could you be more specific as to why these sources have been "very naughty"?
> >>
> >> > Should people feel strongly about them, we might be able to move them
> >> > over to the doc repository.
> >> >
> >>
> >> I strongly object this removal. As already pointed out by others, there
> >> are papers documenting vi/ex and RPC/XDR. These papers are practically
> >> the only docs available on these subjects, apart from the very terse man
> >> pages. There are also tutorials on e.g. Yacc and Lex, that probably are
> >> not that up-to-date but quite short and (at least for now) readily
> >> available. And there is also the IPC Tutorial.
> >>
> >> This may not all be documents that are immediately needed for
> >> operational purposes, but they do offer much needed background
> >> information, also of historical character, i.e. how and why things
> >> became as they are today.
> >
> > The handbook provides even more useful documentation and information,
> > yet we don't have xsltproc in the base system, force everyone to compile
> > it twice and then typeset all the documentation over and over again.
> >
> > They will therefore be moved to the doc repository were they probably
> > should have been all along.
> 
> How about converting them to SGML and integrating them into
> the Handbook (with the caveat that they are outdated, but
> retained for archival purposes)?

We recently removed several outdated articles from the doc repo, so spending
time on converting outdated stuff to XML and adding them to the doc repo makes
no sense at all.

-- 
Joel