[BackupPC-devel] [PATCH] Documentation fixes/suggestions

[Frans P. <el...@pl...>]

On Thursday 06 September 2007, you wrote:
> > Is it correct that /doc/BackupPC.html is generated before release from
> > /doc/BackupPC.pod using 'pod2html'?
>
> Yes.

Thought so. I have some good news then.
A few days ago I noticed that the indentation in the HTML version of the 
BackupPC documentation was rather broken. Yesterday I spent some time 
fixing Pod:Html to correct this. Patch has been filed in Debian [1] and 
with Perl upstream.

You may want to consider applying that patch locally. It does make a huge 
difference; compare:
-http://backuppc.sourceforge.net/faq/BackupPC.html#other_installation_topics
-http://alioth.debian.org/~fjp-guest/tmp/BackupPC.html#other_installation_topics
and
-http://backuppc.sourceforge.net/faq/BackupPC.html#storage_layout
-http://alioth.debian.org/~fjp-guest/tmp/BackupPC.html#storage_layout

> > If so, I guess I only need to submit patches for BackupPC.pod, correct?
>
> Yes.  The real source is the CVS version, prior to running makeDist.
[...]

Thanks for the info!

Attached a patch for the pod file. Details of the changes can be found at 
the top of the diff. Feel free to ignore/change anything you don't agree
with. The version on alioth (see links above) includes my changes.

Cheers,
FJP

[1] http://bugs.debian.org/440946