Home CVS Mailinglists Documentation Download
[Slony1-general] Fwd: Re: [Slony1-hackers] Re : Re : Re : Re : Re : Slony 2.1.0 PDF Documentation available
Steve Singer ssinger at ca.afilias.info
Fri Oct 28 05:36:03 PDT 2011 
On 11-10-27 07:49 PM, Christopher Browne wrote:

> ---------- Forwarded message ----------
> From: "Christopher Browne" <cbbrowne at afilias.info
> <mailto: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 <mailto: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?

The release script (tools/build_release.sh) is already in git I wouldn't 
want to store it in two locations.

That script can be run to make a tag + tar files by anyone who clones 
the slony git repository. It doesn't require login credentials to 
www.slony.info and I wouldn't want to change that.

Maybe we need a second script that handles the slony.info side of 
things.  The nice thing about 3.a and 3.c are that it doens't require 
any new steps at deployment time.  You just untar the -docs tarfile 
(which we already do) and the PDF is there.




>
> On Oct 27, 2011 6:34 PM, "David TECHER" <davidtecher at yahoo.fr
> <mailto: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
>     <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 :* 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
>     <http://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
>     <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 :* 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 <http://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
>     <http://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>
>      > <mailto:ssinger at ca.afilias.info <mailto:ssinger at ca.afilias.info>>>
>      > > *À :* David TECHER <davidtecher at yahoo.fr
>     <mailto:davidtecher at yahoo.fr> <mailto:davidtecher at yahoo.fr
>     <mailto:davidtecher at yahoo.fr>>>
>      > > *Cc :* Devrim GÜNDÜZ <devrim at gunduz.org
>     <mailto:devrim at gunduz.org> <mailto:devrim at gunduz.org
>     <mailto:devrim at gunduz.org>>>;
>      > 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 :* 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>>
>     <mailto: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>>
>      > <mailto: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>>
>      > > <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>>>>
>      > > > *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>>
>      > <mailto: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>>
>     <mailto: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>>
>      > > <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>>>>
>      > > > *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
>     <http://slony.info> :)
>      > > >
>      > > > Thanks for the work!
>      > > >
>      > > > I really want to see it in slony.info <http://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://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>>>
>      > > <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
>     <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>>
>      > <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>
>     http://lists.slony.info/mailman/listinfo/slony1-hackers
>
>
>
> _______________________________________________
> Slony1-general mailing list
> Slony1-general at lists.slony.info
> http://lists.slony.info/mailman/listinfo/slony1-general
More information about the Slony1-general mailing list

Content © 2007 Slony Development Group - Hosting provided by Command Prompt, Inc.