Re: new release documentation

Lee <[email protected]> wrote:

> On 1/5/13, Lee <[email protected]> wrote:
> > The developer manual builds OK for me and the user manual looks like
> > it's just (mainly?) missing a few "</sect3>" lines.

Apparently even the syntax errors don't always "work" cross-platform ...

> > I'll start working on the fixes unless someone else would rather do it.
> 
> Well.. that was easy!  Copyright date needs to be bumped, Ian isn't
> listed as a developer and 3.0.20 isn't marked as beta are the obvious
> things that need fixing.

Are you referring to the "Current Privoxy Team" section?

I agree that Ian is a developer, but so are the rest of the
listed team members including yourself.

In my opinion it would make more sense to simply not explicitly
declare David and myself developers to prevent any confusion.

Another option would be to invent fancy titles for everyone ...

> Suggestions on how to share the results welcome.  I created a .zip
> file of current/doc/webserver but at 807KB it's probably too large to
> email as an attachment.

In general you can simply push documentation changes to CVS
(which I just did for the less problematic HTML parts), preferably
after checking the diff to make sure there aren't too many gratuitous
white-space changes.

Theoretically the dok-tidy target should prevent this for the
HTML parts, but I don't know if the output is stable across
platforms.

In my experience generating the HTML parts causes usually less
problems than the text parts (config, README ...) which at least
on my system always need manual intervention afterwards.

If the HTML generation fails you usually get some kind of error,
but the text generation just silently produces garbage.

Fabian

------------------------------------------------------------------------------
Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, CSS,
MVC, Windows 8 Apps, JavaScript and much more. Keep your skills current
with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft
MVPs and experts. ON SALE this month only -- learn more at:
http://p.sf.net/sfu/learnmore_123012

_______________________________________________
Ijbswa-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/ijbswa-developers

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (FreeBSD)

iEYEARECAAYFAlDpZeIACgkQSMVSH78upWNXmACfd1cy7dWZj48Zxw2MM1aX4TPH
AqUAn1QC9Y7iurmmdlVlBhbRskS7CZiH
=c/fC
-----END PGP SIGNATURE-----