SVN finally fully enabled as source for website manuals

[Frank Lichtenheld]

Hi.

After some prodding on IRC I've realized that I had abandoned the switch
from the DDP CVS to DDP SVN in the middle and some crucial steps were
missing. I'm sorry for this delay.

The infrastructure should now be fixed to use the SVN only.

Some issues which might need fixes by the respective maintainers
(sorry for the German locale, but I guess the error message should be clear enough):

make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/securing-howto'
echo "<!ENTITY language \"es\">"                 > securing-debian-howto.es.ent
echo "<!ENTITY % lang-es \"INCLUDE\">"          >> securing-debian-howto.es.ent
echo "<!ENTITY docdate \"`LC_ALL=C date -R`\">" >> securing-debian-howto.es.ent
echo "<!ENTITY docversion \"CVS\">"             >> securing-debian-howto.es.ent
debiandoc2html -l   es -c securing-debian-howto.es.sgml
saspconvert: es/after-compromise.sgml:62 (input line 9883): identifier `vulnerable-system' is undefined
saspconvert: es/titletoc.sgml:9 (input line 27): identifier `authors' is undefined
saspconvert: es/before-install.sgml:156 (input line 2596): identifier `fw-security-update' is undefined
saspconvert: es/before-install.sgml:171 (input line 2617): identifier `user-pwgen' is undefined
saspconvert: es/before-install.sgml:216 (input line 2706): identifier `auth-pam' is undefined
saspconvert: es/before-install.sgml:614 (input line 3730): identifier `security-update' is undefined
make[1]: *** [securing-debian-howto.es.html.stamp] Fehler 1

make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/faq'
make[1]: *** Keine Regel, um »publish« zu erstellen.  Schluss.
make[1]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/faq'

make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
make[1]: *** Keine Regel, um »publish« zu erstellen.  Schluss.
make[1]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'

Gruesse,
--
Frank Lichtenheld <djpig@...>
www: http://www.djpig.de/


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Lucas Nussbaum]

On 16/06/08 at 23:46 +0200, Frank Lichtenheld wrote:
> make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
> make[1]: *** Keine Regel, um »publish« zu erstellen.  Schluss.
> make[1]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'

Hi,

AFAIK, neither Raphael, Marc or me are similiar with the DDP
infrastructure, so it would make more sense of one of you fixed this, or
pointed us to an example that we could blindly trust.
--
| Lucas Nussbaum
| lucas@...   http://www.lucas-nussbaum.net/ |
| jabber: lucas@...             GPG: 1024D/023B3F4F |


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Jens Seidel]

On Tue, Jun 17, 2008 at 07:41:47AM +0200, Lucas Nussbaum wrote:
> On 16/06/08 at 23:46 +0200, Frank Lichtenheld wrote:
> > make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
> > make[1]: *** Keine Regel, um »publish« zu erstellen.  Schluss.
> > make[1]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
>
> AFAIK, neither Raphael, Marc or me are similiar with the DDP

What DDP infrastructure? There is a publish make target and probably a
cron script which starts it every 4 hours. That should be all!

> infrastructure, so it would make more sense of one of you fixed this, or

I fixed it yesterday.

> pointed us to an example that we could blindly trust.

What example? You mean a good sample document you can use as template
for a new one?

Jens


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Lucas Nussbaum]

On 17/06/08 at 09:31 +0200, Jens Seidel wrote:
> On Tue, Jun 17, 2008 at 07:41:47AM +0200, Lucas Nussbaum wrote:
> > pointed us to an example that we could blindly trust.
>
> What example? You mean a good sample document you can use as template
> for a new one?

A document that has that publish target, and where it does what it is
expected to do.

Anyway, thank you :-)
--
| Lucas Nussbaum
| lucas@...   http://www.lucas-nussbaum.net/ |
| jabber: lucas@...             GPG: 1024D/023B3F4F |


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Raphael Hertzog-3]

On Tue, 17 Jun 2008, Jens Seidel wrote:

> On Tue, Jun 17, 2008 at 07:41:47AM +0200, Lucas Nussbaum wrote:
> > On 16/06/08 at 23:46 +0200, Frank Lichtenheld wrote:
> > > make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
> > > make[1]: *** Keine Regel, um »publish« zu erstellen.  Schluss.
> > > make[1]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
> >
> > AFAIK, neither Raphael, Marc or me are similiar with the DDP
>
> What DDP infrastructure? There is a publish make target and probably a
> cron script which starts it every 4 hours. That should be all!

He's referring to what is needed in that publish rule...

> > infrastructure, so it would make more sense of one of you fixed this, or
>
> I fixed it yesterday.

No you didn't, there's still no "publish" rule in
manuals/trunk/developers-reference/Makefile.

> > pointed us to an example that we could blindly trust.
>
> What example? You mean a good sample document you can use as template
> for a new one?

No, a sample of what has to be put in the publish rule...

Here the old Makefile of developers-reference for reference:
http://cvs.debian.org/ddp/manuals.sgml/developers-reference/Makefile?root=debian-doc&view=markup


Cheers,
--
Raphaël Hertzog

Le best-seller français mis à jour pour Debian Etch :
http://www.ouaza.com/livre/admin-debian/


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Jens Seidel]

On Tue, Jun 17, 2008 at 09:59:49AM +0200, Raphael Hertzog wrote:

> On Tue, 17 Jun 2008, Jens Seidel wrote:
> > On Tue, Jun 17, 2008 at 07:41:47AM +0200, Lucas Nussbaum wrote:
> > > On 16/06/08 at 23:46 +0200, Frank Lichtenheld wrote:
> > > > make[1]: Entering directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
> > > > make[1]: *** Keine Regel, um »publish« zu erstellen.  Schluss.
> > > > make[1]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
> > >
> > > AFAIK, neither Raphael, Marc or me are similiar with the DDP
> >
> > What DDP infrastructure? There is a publish make target and probably a
> > cron script which starts it every 4 hours. That should be all!
>
> He's referring to what is needed in that publish rule...

Ah, OK.

> > > infrastructure, so it would make more sense of one of you fixed this, or
> >
> > I fixed it yesterday.
>
> No you didn't, there's still no "publish" rule in
> manuals/trunk/developers-reference/Makefile.

You're right. I referred to the error in securing-howto/. I haven't seen
the errors with the publish target :-) Will try to fix it later this
day.

There was also a recently introduced bug in
developers-reference/ja/resources.po (syntax errors) which I fixed now.

Jens


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Josip Rodin-7]

On Mon, Jun 16, 2008 at 11:46:33PM +0200, Frank Lichtenheld wrote:
> Hi.
>
> After some prodding on IRC I've realized that I had abandoned the switch
> from the DDP CVS to DDP SVN in the middle and some crucial steps were
> missing. I'm sorry for this delay.
>
> The infrastructure should now be fixed to use the SVN only.

Er, make that *now*, after a few obvious fixes in the script :)

We need some way of showing make.log from that build to others. ISTR some
symlink in the build-logs directory on www-master... I'll go look.

--
     2. That which causes joy or happiness.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Josip Rodin-7]

On Tue, Jun 24, 2008 at 04:10:28PM +0200, joy wrote:

> On Mon, Jun 16, 2008 at 11:46:33PM +0200, Frank Lichtenheld wrote:
> > Hi.
> >
> > After some prodding on IRC I've realized that I had abandoned the switch
> > from the DDP CVS to DDP SVN in the middle and some crucial steps were
> > missing. I'm sorry for this delay.
> >
> > The infrastructure should now be fixed to use the SVN only.
>
> Er, make that *now*, after a few obvious fixes in the script :)
>
> We need some way of showing make.log from that build to others. ISTR some
> symlink in the build-logs directory on www-master... I'll go look.

Ah, there it is... and you also added the symlinks to new files. I removed
the old symlinks, and now it's straightforward:

http://www-master.debian.org/build-logs/ddp/

--
     2. That which causes joy or happiness.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Raphael Hertzog-3]

On Tue, 24 Jun 2008, Josip Rodin wrote:
> Ah, there it is... and you also added the symlinks to new files. I removed
> the old symlinks, and now it's straightforward:
>
> http://www-master.debian.org/build-logs/ddp/

Thanks for this.

I added a publish rule for developers-refernce now, but the build fails on
www-master.

If anyone has the time to look into this and to provide whatever backport is
needed to get it to work, it would be great (on sid it compiles fine). :-|

make[2]: Leaving directory `/org/www.debian.org/ddp-svn/trunk/developers-reference'
TOP=`pwd` && cd /org/www.debian.org/ddp-svn/trunk/developers-reference && dblatex --style=db2latex index.dbk \
            && mv index.dbk.pdf developers-reference.pdf
XSLT stylesheets DocBook -  LaTeX 2e (0.2-2)
===================================================
This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4)
entering extended mode
/tmp/tmpE516sa/index.dbk_tmp.tex:4187: pdfTeX warning (ext4): destination with the same identifier (name{table.5.1}) has been already used, duplicate ignored
/tmp/tmpE516sa/index.dbk_tmp.tex:5879: Paragraph ended before \lst@next was complete.
/tmp/tmpE516sa/index.dbk_tmp.tex:5879: leading text: }
/tmp/tmpE516sa/index.dbk_tmp.tex:5879: Display math should end with $$.
/tmp/tmpE516sa/index.dbk_tmp.tex:5879: leading text: }
/tmp/tmpE516sa/index.dbk_tmp.tex:5879: Missing $ inserted.
/tmp/tmpE516sa/index.dbk_tmp.tex:5879: leading text: }
Error: pdflatex compilation failed
Build the listings...
pdflatex failed

Cheers,
--
Raphaël Hertzog

Le best-seller français mis à jour pour Debian Etch :
http://www.ouaza.com/livre/admin-debian/


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[W. Martin Borgert]

On Fri, Jun 27, 2008 at 08:11:43AM +0200, Raphael Hertzog wrote:
> I added a publish rule for developers-refernce now, but the build fails on
> www-master.
>
> If anyone has the time to look into this and to provide whatever backport is
> needed to get it to work, it would be great (on sid it compiles fine). :-|

Frank reported a problem like this 2008-03-04. I suggested using
dblatex 0.2.8-6 instead of 0.2-2, but don't know whether that
helped. No reply == all went well, right? :~)

Questions:
- Why do we build documentation for www-master?
- Why don't we just use the documentation package?
- If we can't install the latest package for dependency reasons,
  we could unpack the deb, or what am I missing here?

Cheers.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Raphael Hertzog-3]

On Fri, 27 Jun 2008, W. Martin Borgert wrote:
> Frank reported a problem like this 2008-03-04. I suggested using
> dblatex 0.2.8-6 instead of 0.2-2, but don't know whether that
> helped. No reply == all went well, right? :~)

Well, if nobody tries, then we'll never know for sure. :)

> Questions:
> - Why do we build documentation for www-master?

To have the latest and greatest immediately available ?

> - Why don't we just use the documentation package?
> - If we can't install the latest package for dependency reasons,
>   we could unpack the deb, or what am I missing here?

If you want to change this, feel free to go ahead but in the mean time I'm
just interested in having an updated version of developers-reference
online. :-|

Cheers,
--
Raphaël Hertzog

Le best-seller français mis à jour pour Debian Etch :
http://www.ouaza.com/livre/admin-debian/


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[W. Martin Borgert]

On Fri, Jun 27, 2008 at 04:33:06PM +0200, Raphael Hertzog wrote:
> Well, if nobody tries, then we'll never know for sure. :)

I tried that, of course, and it worked on my machine. I didn't
try on www-master, however.

> If you want to change this, feel free to go ahead but in the mean time I'm
> just interested in having an updated version of developers-reference
> online. :-|

Sure. How do other debian-doc people think? Do you prefer the
current SVN or the latest package? I prefer the latter.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Josip Rodin-7]

On Fri, Jun 27, 2008 at 04:04:42PM +0200, W. Martin Borgert wrote:

> On Fri, Jun 27, 2008 at 08:11:43AM +0200, Raphael Hertzog wrote:
> > I added a publish rule for developers-refernce now, but the build fails on
> > www-master.
> >
> > If anyone has the time to look into this and to provide whatever backport is
> > needed to get it to work, it would be great (on sid it compiles fine). :-|
>
> Frank reported a problem like this 2008-03-04. I suggested using
> dblatex 0.2.8-6 instead of 0.2-2, but don't know whether that
> helped. No reply == all went well, right? :~)
>
> Questions:
> - Why do we build documentation for www-master?
> - Why don't we just use the documentation package?

We extract files from documentation packages - in places where it is
necessary. If you want we (webmaster, debwww) can make it so for developer's
reference, and then re-link the main indices to that location (leaving the
SVN-build link separate).

If you want dblatex upgraded on the www-master machine, please make sure
that a stable backport exists on backports.org and file an RT ticket at
rt.debian.org, DSA queue.

--
     2. That which causes joy or happiness.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[W. Martin Borgert]

On Fri, Jun 27, 2008 at 07:09:41PM +0200, Josip Rodin wrote:
> We extract files from documentation packages - in places where it is
> necessary. If you want we (webmaster, debwww) can make it so for developer's
> reference, and then re-link the main indices to that location (leaving the
> SVN-build link separate).

So far, nobody spoke up against it. How can I help to change the
process?

> If you want dblatex upgraded on the www-master machine, please make sure
> that a stable backport exists on backports.org and file an RT ticket at
> rt.debian.org, DSA queue.

To me the first method sounds like the easier and secure one,
esp. in the long run. (E.g. AFAIK, backports.org has no official
security support.)

Cheers!


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Josip Rodin-7]

On Tue, Jul 08, 2008 at 07:54:06PM +0200, W. Martin Borgert wrote:
> On Fri, Jun 27, 2008 at 07:09:41PM +0200, Josip Rodin wrote:
> > We extract files from documentation packages - in places where it is
> > necessary. If you want we (webmaster, debwww) can make it so for developer's
> > reference, and then re-link the main indices to that location (leaving the
> > SVN-build link separate).
>
> So far, nobody spoke up against it. How can I help to change the
> process?

Well, the difference between me pasting the path you tell me and doing
dpkg-deb -c on the .deb package is minor :)

> > If you want dblatex upgraded on the www-master machine, please make sure
> > that a stable backport exists on backports.org and file an RT ticket at
> > rt.debian.org, DSA queue.
>
> To me the first method sounds like the easier and secure one,
> esp. in the long run.

It would still make sense to do it in the long run, because the automatic
build on www-master is a good regression test, and it allows people to
preview the newest versions of documents without having to use VCS and
without having them packaged.

> (E.g. AFAIK, backports.org has no official security support.)

That shouldn't really matter for these things, because they build docs from
reasonably safe data (with a trail in VCS), and even if that gets corrupted,
they build under a special unprivileged user so any impact would be limited.

--
     2. That which causes joy or happiness.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[W. Martin Borgert]

On Wed, Jul 09, 2008 at 12:52:50PM +0200, Josip Rodin wrote:
> On Tue, Jul 08, 2008 at 07:54:06PM +0200, W. Martin Borgert wrote:
> > So far, nobody spoke up against it. How can I help to change the
> > process?
>
> Well, the difference between me pasting the path you tell me and doing
> dpkg-deb -c on the .deb package is minor :)

Obviously. Post the path anyway for my and the publics
education, please :)

> It would still make sense to do it in the long run, because the automatic
> build on www-master is a good regression test, and it allows people to
> preview the newest versions of documents without having to use VCS and
> without having them packaged.

True. To minimize the duplication of build processes and test
the package build process as well, maybe autobuilding of the
packages and upload to some place (of course not unstable, nor
experimental), would be good.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Josip Rodin-7]

On Wed, Jul 09, 2008 at 03:50:55PM +0200, W. Martin Borgert wrote:
> > > So far, nobody spoke up against it. How can I help to change the
> > > process?
> >
> > Well, the difference between me pasting the path you tell me and doing
> > dpkg-deb -c on the .deb package is minor :)
>
> Obviously. Post the path anyway for my and the publics
> education, please :)

Er, it's /usr/share/doc/developers-reference/*.html. I'm just adding it.

--
     2. That which causes joy or happiness.


--
To UNSUBSCRIBE, email to debian-doc-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Javier Fernandez-Sanguino Pen~a-2]

On Fri, Jun 27, 2008 at 05:05:50PM +0200, W. Martin Borgert wrote:
> Sure. How do other debian-doc people think? Do you prefer the
> current SVN or the latest package? I prefer the latter.

Current SVN, for sure.

I'm not sure how you want to get the packages installed in www-master (or
automatically extracted) but I do prefer for any changes I make in SVN to
reflect inmediately at the website.

Regards

Javier