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
>  >
>  >
>  >
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.slony.info/pipermail/slony1-hackers/attachments/20111027/828c3a5c/attachment-0001.htm