[Docutils-develop] Re: LaTeX stylesheet settings

[Felix W. <Fel...@gm...>]

David Goodger wrote:

> While converting Docutils over to use support files in the
> docutils/writers/support directory, I noticed that the latex2e writer
> has both stylesheet & stylesheet_path settings.  There, stylesheet
> seems to be the equivalent of an embedded stylesheet_path.  The
> newlatex2e writer has the same semantics on its settings, but adds
> user_stylesheet and user_stylesheet_path.

Regarding the newlatex2e writer, what's now the "stylesheet[-path]"
setting will be removed in the future because there is no need to change
the link to base.tex; anything can be overridden in a user stylesheet.
"--user-stylesheet" (without "-path") will be removed as well because
it's effectively useless (I assume). --user-stylesheet-path will be
renamed to --stylesheet-path.

For the latex2e writer, we *could* remove --stylesheet, but that would
break existing configurations.  Since I expect to replace the old with
the new writer sooner or later, I suggest we leave it as is for now.

> These settings should be rationalized and unified.

+1 in general, -0 on doing it now.  I suggest we wait until the new
LaTeX writer is finished (in about two or three months) so that we keep
the amount of work low.

-- 
For private mail please ensure that the header contains 'Felix Wiemann'.

"the number of contributors [...] is strongly and inversely correlated with the
number of hoops each project makes a contributing user go through."      -- ESR