---------- Forwarded message ----------
From: "Christopher Browne" <cbbrowne at afilias.info>
Date: Oct 27, 2011 7:48 PM
Subject: Re: [Slony1-hackers] Re : Re : Re : Re : Re : Slony 2.1.0 PDF
Documentation available
To: "David TECHER" <davidtecher at yahoo.fr>

All the options have varying bits of new complexity / new apparatus, so any
choice involves a little more work.  I think I like 3b too, as it seems to
have fewer "moving parts" than most of the others.

Ideally 3b involves scripting dropping the PDF into the
less-processed-by-PHP area, as opposed to us needing to remember Yet Another
Deployment Rule.

I suppose more work should go into the release script, which I'll observe
that I changed a bit when doing 2.1.0...

Maybe that script should need a CVS repo location, and actually put the
build into place?
On Oct 27, 2011 6:34 PM, "David TECHER" <davidtecher at yahoo.fr> wrote:

> Steve,
>
> My personal choice will be for 3.b. It seems to be the simpliest choice
>
> I will wait you discuss with Chris.
>
> For next release of Slony 2.1.1or higher, I will be able to test if
> something need to be change.
>
> Thanks.
>
> David
>
> ------------------------------
> *De :* Steve Singer <ssinger at ca.afilias.info>
> *À :* David TECHER <davidtecher at yahoo.fr>
> *Cc :* Devrim GÜNDÜZ <devrim at gunduz.org>; Slony Hackers <
> slony1-hackers at lists.slony.info>
> *Envoyé le :* Jeudi 27 Octobre 2011 23h46
> *Objet :* Re: Re : Re : [Slony1-hackers] Re : Re : Slony 2.1.0 PDF
> Documentation available
>
> On 11-10-27 04:46 PM, David TECHER wrote:
> > Steve
> >
> > When do you think you will push the PDF on slony.info?
>
> I have committed this patch to git.  I can
>
> 1) Build a new slony1-engine-2.1.0-1-docs.tar.bz2 that includes the PDF.
>   Not the extra -1 in the filename.  I am open to a different scheme for
> naming updated tar files for a release that has already been released.
>
> 2)  Wait until 2.1.1 gets released (When enough bug fixes accumulate for
> a 2.1.1 to be justified)
>
> 3) I can put the PDF file up on the website outside of a tar file.
> If we go this route I'd be inclined to add a PDF link next to  the
> existing HTML link on  http://www.slony.info/documentation/.  I would
> only do this for 2.1 and new versions going forward.  There are some
> complications in doing this with the PHP could that generates the
> website I can
>
> a) Modify the PHP to return .PDF files without the HTML header, but this
> still would involve reading the entire PDF into memory in the PHP script
> and returning it
> b) We can manually copy the PDF out of
> documentation/2.1/.../adminguide./slony.pdf to somewhere else in the
> directory tree that doesn't invoke the index.php script.
> c) Find someone who understands and can edit the rewrite rules that make
> index.php get invoked when the PDF lives under documentation/...
>
> If we like option 3 then I  don't see a decision on a-c happening until
> I talk to Chris next week.
>
>
>
> >
> > Kind regards.
> >
> >
> > David.
> >
> > ------------------------------------------------------------------------
> > *De :* Steve Singer <ssinger at ca.afilias.info>
> > *À :* David TECHER <davidtecher at yahoo.fr>
> > *Cc :* Devrim GÜNDÜZ <devrim at gunduz.org>; Slony Hackers
> > <slony1-hackers at lists.slony.info>
> > *Envoyé le :* Mercredi 26 Octobre 2011 19h28
> > *Objet :* Re: Re : [Slony1-hackers] Re : Re : Slony 2.1.0 PDF
> > Documentation available
> >
> > On 11-10-24 06:47 PM, David TECHER wrote:
> >  > For sure
> >
> > Thanks.
> >
> > I've produced this patch to have the
> > make slony.pdf target use this steps instead of the jadetex ones. The
> > old commands seemed to work for me as well but it took a really long
> > time for the pdf to run.
> >
> > With this patch slony.pdf will be included in the -doc tar file that
> > gets built/pushed to the slony.info site.
> >
> > Any comments?
> >
> >
> >
> >  >
> >  > Step 1 - Dblatex
> >  > ------------------------
> >  > First of all be sure that you have dblatex installed
> >  >
> >  > since I am on Ubuntu Lucid, I've did
> >  >
> >  > apt-get install -y dblatex
> >  >
> >  > Notice: I've tryied it with dblatex 0.2.12-4 (Ubuntu Lucid) and with
> the
> >  > last version 0.3 available from dblatex.sf.net.
> >  > The two versions are Ok for me. However I am not able to confirm that
> my
> >  > commands will work for dblatex < 0.2.12
> >  >
> >  > Then
> >  >
> >  > Step 2 - Generating the PDF
> >  > -------------------------------------
> >  > # As usual, generate the XML file
> >  > cd doc/adminguide
> >  > make slony.xml
> >  >
> >  > # we need to make a few changes: replacing 'article' by 'sect1' else
> we
> >  > will not be able to use Latex
> >  > sed -i "s:<article:<sect1:g;s:</article:</sect1:g" slony.xml;
> >  >
> >  > # We use dblatex to generate a temporary Tex file named (for example)
> >  > 'slony-tmp.tex'
> >  > dblatex -t tex -o slony-tmp.tex slony.xml
> >  >
> >  > # We drop bad lines "\end{document}" generated by dblatex
> >  > grep -vE '^(\\end{document}|\\subsection\*)$' slony-tmp.tex >
> slony.tex
> >  >
> >  > # We put the required '\end{document}' at the end of the Tex file
> >  > echo "\end{document}" >> slony.tex
> >  >
> >  > # Latex required to run the following command 3 times in order to
> >  > generating the TOC of the document
> >  >
> >  > pdflatex slony.tex
> >  > pdflatex slony.tex
> >  > pdflatex slony.tex
> >  >
> >  > Then the PDF file is generated.
> >  >
> >  > That's all.
> >  >
> >  >
> >  >
> ------------------------------------------------------------------------
> >  > *De :* Steve Singer <ssinger at ca.afilias.info
> > <mailto:ssinger at ca.afilias.info>>
> >  > *À :* David TECHER <davidtecher at yahoo.fr <mailto:davidtecher at yahoo.fr
> >>
> >  > *Cc :* Devrim GÜNDÜZ <devrim at gunduz.org <mailto:devrim at gunduz.org>>;
> > Slony Hackers
> >  > <slony1-hackers at lists.slony.info
> > <mailto:slony1-hackers at lists.slony.info>>
> >  > *Envoyé le :* Lundi 24 Octobre 2011 16h22
> >  > *Objet :* Re: [Slony1-hackers] Re : Re : Slony 2.1.0 PDF Documentation
> >  > available
> >  >
> >  > On 11-10-23 12:44 PM, David TECHER wrote:
> >  > > If you are interested, the files used to generated the pdf are
> > joined to
> >  > > this mail.
> >  > >
> >  > > slony.xml:
> >  > >
> >  > > The file you've got when you do
> >  > >
> >  > > make slony.xml
> >  > >
> >  > > I had to modify it manually.
> >  > >
> >  > > slony.tex:
> >  > >
> >  > > do
> >  > >
> >  > > pdflatex slony.tex
> >  > >
> >  > > Be sure to have the image 'complexenv.png' in the same directory
> where
> >  > > the command is executed
> >  >
> >  > To include this in the -doc tar builds going forward I need to know
> what
> >  > commands to execute to build the PDF from the xml sources.
> >  >
> >  > $ cd doc/adminguide
> >  > $ make slony.xml
> >  >
> >  > then what? Do I need to run
> >  >
> >  > $ make slony.pdf
> >  >
> >  > or something else?
> >  >
> >  > >
> >  > >
> > ------------------------------------------------------------------------
> >  > > *De :* David TECHER <davidtecher at yahoo.fr
> > <mailto:davidtecher at yahoo.fr> <mailto:davidtecher at yahoo.fr
> > <mailto:davidtecher at yahoo.fr>>>
> >  > > *À :* Devrim GÜNDÜZ <devrim at gunduz.org <mailto:devrim at gunduz.org>
> > <mailto:devrim at gunduz.org <mailto:devrim at gunduz.org>>>
> >  > > *Cc :* Slony Hackers <slony1-hackers at lists.slony.info
> > <mailto:slony1-hackers at lists.slony.info>
> >  > <mailto:slony1-hackers at lists.slony.info
> > <mailto:slony1-hackers at lists.slony.info>>>
> >  > > *Envoyé le :* Dimanche 23 Octobre 2011 17h53
> >  > > *Objet :* [Slony1-hackers] Re : Slony 2.1.0 PDF Documentation
> available
> >  > >
> >  > > Devrim,
> >  > >
> >  > > I hope so.
> >  > >
> >  > > Thanks for your mail.
> >  > >
> >  > > David.
> >  > >
> >  > >
> > ------------------------------------------------------------------------
> >  > > *De :* Devrim GÜNDÜZ <devrim at gunduz.org <mailto:devrim at gunduz.org>
> > <mailto:devrim at gunduz.org <mailto:devrim at gunduz.org>>>
> >  > > *À :* David TECHER <davidtecher at yahoo.fr
> > <mailto:davidtecher at yahoo.fr> <mailto:davidtecher at yahoo.fr
> > <mailto:davidtecher at yahoo.fr>>>
> >  > > *Cc :* Slony Hackers <slony1-hackers at lists.slony.info
> > <mailto:slony1-hackers at lists.slony.info>
> >  > <mailto:slony1-hackers at lists.slony.info
> > <mailto:slony1-hackers at lists.slony.info>>>
> >  > > *Envoyé le :* Samedi 22 Octobre 2011 10h42
> >  > > *Objet :* Re: [Slony1-hackers] Slony 2.1.0 PDF Documentation
> available
> >  > >
> >  > > On Fri, 2011-10-21 at 23:50 +0100, David TECHER wrote:
> >  > > >
> >  > > > The documentation is available at
> >  > > >
> http://www.davidgis.fr/documentation/slony/2.1.0/pdf/slony-2.1.0.pdf
> >  > > >
> >  > > > I did not attached the PDF to the mail (big file 1M even if
> >  > > > compressed).
> >  > > >
> >  > > > Let me know if you want to put it on slony.info :)
> >  > >
> >  > > Thanks for the work!
> >  > >
> >  > > I really want to see it in slony.info, so that I can push this PDF
> > along
> >  > > with RPMs.
> >  > >
> >  > > Regards,
> >  > > --
> >  > > Devrim GÜNDÜZ
> >  > > Principal Systems Engineer @ EnterpriseDB:
> http://www.enterprisedb.com
> >  > > PostgreSQL Danışmanı/Consultant, Red Hat Certified Engineer
> >  > > Community: devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
> >  > > http://www.gunduz.org Twitter: http://twitter.com/devrimgunduz
> >  > >
> >  > >
> >  > >
> >  > > _______________________________________________
> >  > > Slony1-hackers mailing list
> >  > > Slony1-hackers at lists.slony.info
> > <mailto:Slony1-hackers at lists.slony.info>
> >  > <mailto:Slony1-hackers at lists.slony.info
> > <mailto:Slony1-hackers at lists.slony.info>>
> >  > <mailto:Slony1-hackers at lists.slony.info
> > <mailto:Slony1-hackers at lists.slony.info>
> >  > <mailto:Slony1-hackers at lists.slony.info
> > <mailto:Slony1-hackers at lists.slony.info>>>
> >  > > http://lists.slony.info/mailman/listinfo/slony1-hackers
> >  > >
> >  > >
> >  > >
> >  > >
> >  > > _______________________________________________
> >  > > Slony1-hackers mailing list
> >  > > Slony1-hackers at lists.slony.info
> > <mailto:Slony1-hackers at lists.slony.info>
> > <mailto:Slony1-hackers at lists.slony.info
> > <mailto:Slony1-hackers at lists.slony.info>>
> >  > > http://lists.slony.info/mailman/listinfo/slony1-hackers
> >  >
> >  >
> >  >
> >
> >
> >
>
>
>
>
> _______________________________________________
> Slony1-hackers mailing list
> Slony1-hackers at lists.slony.info
> http://lists.slony.info/mailman/listinfo/slony1-hackers
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.slony.info/pipermail/slony1-general/attachments/20111027/79a7316d/attachment-0001.htm