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

From: C. P. Ghost <cpghost_at_cordula.ws>
Date: Mon, 22 Oct 2012 14:53:11 +0200
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)?

> Cheers,
> Uli

-cpghost.

-- 
Cordula's Web. http://www.cordula.ws/
Received on Mon Oct 22 2012 - 10:53:12 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:40:31 UTC