Re: Lintian man pages in pod
Niels Thykier <niels@thykier.net> writes:
> Done. I made some changes to the script so it tries to highlight paths,
> and substitutes a few html tags (which were already used in the desc
> files). It also does manpage link substitution:
> <tt>Text</tt> => I<Text>
> <b>Text</b> => B<Text>
> <i>Text</i> => I<Text>
> Text(N) => L<Text(N)>
> I am not sure if there is a better replacement for <tt>, I have only
> used I,B,C and L in pod.
For the way that we use <tt>, F<> is probably marginally better, but the
translation is hard. We could switch to better HTML or pseudo-HTML to
make this problem easier on ourselves, but it probably doesn't matter a
great deal.
> Finally some of the highlighting has changed. In the checks/collection
> sections most of this is related to the old manpage being inconsistent.
> But pod2man also highlights some things differently in general (e.g.
> links are underlined instead of bold).
Yup, I think that's fine.
> I just dumped it there because it does not really belong in any of the
> other directories and creating a "build-helpers" directory seem like
> overkill.
Yeah, I'd probably do the same thing. :)
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: