[Docutils-develop] Re: docutils/docs/user latex.txt,1.51,1.52

[David A. <da...@bo...>]

gr...@us... writes:

> On Mon, 23 Aug 2004, Felix Wiemann wrote:
>
>> gr...@us... wrote:
>>
>> > * both solutions are latex solutions, therefore they are here.
>> > * neither hyphenation nor page numbers are done in html AFAIR.
>>
>> I mean that they don't belong into documentation of the Docutils package
>> at all.
>
> agreed this is not docutils specific, but then i have to answer questions
> forever. i take this is latex stylesheet documentation, and because the
> user should not need to know latex, the documentation must come with
> docutils.
>
>> >> Maybe put it on an external web page?
>> >
>> > if it fits, but we need a link to it from here i guess.
>>
>> If you think it's necessary, you could do that (I could provide
>> webspace, if you need some).
>>
>> I doubt, however, if it's necessary to put the solutions anywhere,
>> because it would just mean duplicating existing information.  There is
>> already a huge amount of information -- it's just a matter of finding
>> it.
>>
>> <http://www.google.com/search?q=page+numbering+chapter+site%3Actan.org>
>> immediately gives the right result, and looking in the 'hyphenation'
>> section of the first result of <http://www.google.com/search?q=tex+faq>
>> solves the hyphenation problem.
>>
>> By putting solutions for 2 of the 1000 possible LaTeX problems into
>> docs/user/latex.txt, the file becomes less readable but it's not helping
>> anyone, because the particular problem the user has is probably among
>> the other 998 problems.
>>
>> So if you don't mind, I'd like the sections to be removed.
>
> but i do mind and i gave the reason above.
> actually ask david abrahams, he is my naggin` user :-) and i will follow
> his vote.

I think if I had known about this file, it would have been very
helpful to me, so for Englebert's sake I'd prefer if it remained.  If
there's some semantic problem the info could be put in a separate
file or website and referenced from there, but keeping the info
around conveniently is a good idea.

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com