samba-docs

[John H Terpstra]

On Tuesday 27 November 2007 06:53, Alexander Bokovoy wrote:
> Karolin Seeger пишет:
> > Hi Alexander, hi Jerry,
> >
> > On Tue, Nov 27, 2007 at 03:33:43PM +0300, Alexander Bokovoy wrote:
> >> I'm currently looking into the set of errors with db2latex all
> >> distributions are experiencing and more I dig I think we just need
> >> to have our own copy of db2latex-xsl within samba-docs because some
> >> changes are intrusive into the db2latex's code and can't be easily
> >> done through XSLT's import/replacement strategies. Thus, they
> >> require certain changes from distro vendors point of view which
> >> isn't flexible. Therefore, making a local copy could help in
> >> maintenance given that upstream for db2latex is hardly reachable
> >> but software itself works: it is libxslt which went into more
> >> strict XSLT standards compliance that broke db2latex.
> >>
> >> Once I'll get that code working again, I think we could import it
> >> into samba-docs and low the bar for distros.
> >
> > Jelmer gave me the hint that there do already forks exist (e.g.
> > dblatex) which are maintained more actively. Using such a fork might
> > be a good solution, because the Samba team does not need to maintain
> > a local copy.
>
> dblatex is broken too. I have it on my Ubuntu 7.10 system and it is no
> save for us as well, unfortunately. When I tried to use it, it broke
> more of our code as it lacks couple of templates we use and which were
> in the original db2latex like generate.hyperlink, set of fasttext
> processing templates, and latex mapping tables.
>
> See http://samba.org/~ab/Samba3-ByExample.pdf as sample output of my
> hacking of db2latex. It has couple of unprocessed references but these
> are because sometimes you have to run pdflatex more than three times and
> our Makefile has no simple way to check that. Other than that I see good
> output.

Alexander,

It may be better to change the way we handle the "<screen>" markups. Could we 
perhaps hold the content to the left of the page and add a border and shading 
as we do for the "<example>" markups, but instread of moving it to the back 
of the chapter, keep it in-line?

I think this will look better than it does now because now screen content runs 
over the right margin.

- John T.