<div class="gmail_quote">---------- Forwarded message ----------<br>From: &quot;Christopher Browne&quot; &lt;<a href="mailto:cbbrowne@afilias.info">cbbrowne@afilias.info</a>&gt;<br>Date: Oct 27, 2011 7:48 PM<br>Subject: Re: [Slony1-hackers] Re : Re : Re : Re : Re : Slony 2.1.0 PDF Documentation available<br>
To: &quot;David TECHER&quot; &lt;<a href="mailto:davidtecher@yahoo.fr">davidtecher@yahoo.fr</a>&gt;<br><br type="attribution"><p>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 &quot;moving parts&quot; than most of the others.</p>

<p>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.</p>
<p> I suppose more work should go into the release script, which I&#39;ll observe that I changed a bit when doing 2.1.0...</p>
<p>Maybe that script should need a CVS repo location, and actually put the build into place?</p>
<div class="gmail_quote"><div class="elided-text">On Oct 27, 2011 6:34 PM, &quot;David TECHER&quot; &lt;<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt; wrote:<br type="attribution"></div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="elided-text">
<div><div style="color:#000;background-color:#fff;font-family:times new roman, new york, times, serif;font-size:12pt"><div><span>Steve,</span></div><div><br><span></span></div><div><span></span><span>My personal choice will be for 3.b. It seems to be the simpliest choice<br>

</span></div><div><br><span></span></div><div><span>I will wait you discuss with Chris.</span></div><div><br><span></span></div><div><span>For next release of Slony 2.1.1or higher, I will be able to test if something need to be change.<br>

</span></div><div><br><span></span></div><div><span>Thanks.</span></div><div><br><span></span></div><div><span>David</span></div><div><br></div><div style="font-family:times new roman, new york, times, serif;font-size:12pt">

<div style="font-family:times new roman, new york, times, serif;font-size:12pt"><font face="Arial" size="2"><hr size="1"><b><span style="font-weight:bold">De :</span></b> Steve Singer
 &lt;<a href="mailto:ssinger@ca.afilias.info" target="_blank">ssinger@ca.afilias.info</a>&gt;<br><b><span style="font-weight:bold">À :</span></b> David TECHER &lt;<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt;<br>

<b><span style="font-weight:bold">Cc :</span></b> Devrim GÜNDÜZ &lt;<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;; Slony Hackers &lt;<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;<br>

<b><span style="font-weight:bold">Envoyé le :</span></b> Jeudi 27 Octobre 2011 23h46<br><b><span style="font-weight:bold">Objet :</span></b> Re: Re : Re : [Slony1-hackers] Re : Re : Slony 2.1.0 PDF Documentation available<br>

</font><br>On 11-10-27 04:46 PM, David TECHER wrote:<br>&gt; Steve<br>&gt;<br>&gt; When do you think you will push the PDF on <a href="http://slony.info" target="_blank">slony.info</a>?<br><br>I have committed this patch to git.  I can<br>

<br>1) Build a new slony1-engine-2.1.0-1-docs.tar.bz2 that includes the PDF. <br>  Not the extra -1 in the filename.  I am open to a different scheme for <br>naming updated tar files for a release that has already been
 released.<br><br>2)  Wait until 2.1.1 gets released (When enough bug fixes accumulate for <br>a 2.1.1 to be justified)<br><br>3) I can put the PDF file up on the website outside of a tar file.<br>If we go this route I&#39;d be inclined to add a PDF link next to  the <br>

existing HTML link on  <a href="http://www.slony.info/documentation/" target="_blank">http://www.slony.info/documentation/</a>.  I would <br>only do this for 2.1 and new versions going forward.  There are some <br>complications in doing this with the PHP could that generates the <br>

website I can<br><br>a) Modify the PHP to return .PDF files without the HTML header, but this <br>still would involve reading the entire PDF into memory in the PHP script <br>and returning it<br>b) We can manually copy the PDF out of <br>

documentation/2.1/.../adminguide./slony.pdf to somewhere else in the <br>directory tree that doesn&#39;t invoke the index.php script.<br>c) Find someone who
 understands and can edit the rewrite rules that make <br>index.php get invoked when the PDF lives under documentation/...<br><br>If we like option 3 then I  don&#39;t see a decision on a-c happening until <br>I talk to Chris next week.<br>

<br><br><br>&gt;<br>&gt; Kind regards.<br>&gt;<br>&gt;<br>&gt; David.<br>&gt;<br>&gt; ------------------------------------------------------------------------<br>&gt; *De :* Steve Singer &lt;<a href="mailto:ssinger@ca.afilias.info" target="_blank">ssinger@ca.afilias.info</a>&gt;<br>

&gt; *À :* David TECHER &lt;<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt;<br>&gt; *Cc :* Devrim GÜNDÜZ &lt;<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;; Slony Hackers<br>

&gt; &lt;<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;<br>&gt; *Envoyé le :* Mercredi 26 Octobre 2011 19h28<br>&gt; *Objet :* Re: Re : [Slony1-hackers] Re : Re : Slony 2.1.0 PDF<br>

&gt; Documentation available<br>&gt;<br>&gt; On 11-10-24 06:47 PM, David TECHER wrote:<br>&gt;  &gt; For sure<br>&gt;<br>&gt; Thanks.<br>&gt;<br>&gt; I&#39;ve produced this patch to have the<br>&gt; make slony.pdf target use this steps instead of the jadetex ones. The<br>

&gt; old commands seemed to work for me as well but it took a really long<br>&gt; time for the pdf to run.<br>&gt;<br>&gt; With this patch slony.pdf will be included in the -doc tar file that<br>&gt; gets built/pushed to the <a href="http://slony.info" target="_blank">slony.info</a> site.<br>

&gt;<br>&gt; Any comments?<br>&gt;<br>&gt;<br>&gt;<br>&gt;  &gt;<br>&gt;  &gt; Step 1 - Dblatex<br>&gt;  &gt; ------------------------<br>&gt;  &gt; First of all be sure that you have dblatex installed<br>&gt; 
 &gt;<br>&gt;  &gt; since I am on Ubuntu Lucid, I&#39;ve did<br>&gt;  &gt;<br>&gt;  &gt; apt-get install -y dblatex<br>&gt;  &gt;<br>&gt;  &gt; Notice: I&#39;ve tryied it with dblatex 0.2.12-4 (Ubuntu Lucid) and with the<br>

&gt;  &gt; last version 0.3 available from <a href="http://dblatex.sf.net" target="_blank">dblatex.sf.net</a>.<br>&gt;  &gt; The two versions are Ok for me. However I am not able to confirm that my<br>&gt;  &gt; commands will work for dblatex &lt; 0.2.12<br>

&gt;  &gt;<br>&gt;  &gt; Then<br>&gt;  &gt;<br>&gt;  &gt; Step 2 - Generating the PDF<br>&gt;  &gt; -------------------------------------<br>&gt;  &gt; # As usual, generate the XML file<br>&gt;  &gt; cd doc/adminguide<br>

&gt;  &gt; make slony.xml<br>&gt;  &gt;<br>&gt;  &gt; # we need to make a few changes: replacing &#39;article&#39; by &#39;sect1&#39; else we<br>&gt;  &gt; will not be able to use Latex<br>&gt;  &gt; sed -i
 &quot;s:&lt;article:&lt;sect1:g;s:&lt;/article:&lt;/sect1:g&quot; slony.xml;<br>&gt;  &gt;<br>&gt;  &gt; # We use dblatex to generate a temporary Tex file named (for example)<br>&gt;  &gt; &#39;slony-tmp.tex&#39;<br>&gt;  &gt; dblatex -t tex -o slony-tmp.tex slony.xml<br>

&gt;  &gt;<br>&gt;  &gt; # We drop bad lines &quot;\end{document}&quot; generated by dblatex<br>&gt;  &gt; grep -vE &#39;^(\\end{document}|\\subsection\*)$&#39; slony-tmp.tex &gt; slony.tex<br>&gt;  &gt;<br>&gt;  &gt; # We put the required &#39;\end{document}&#39; at the end of the Tex file<br>

&gt;  &gt; echo &quot;\end{document}&quot; &gt;&gt; slony.tex<br>&gt;  &gt;<br>&gt;  &gt; # Latex required to run the following command 3 times in order to<br>&gt;  &gt; generating the TOC of the document<br>&gt;  &gt;<br>

&gt;  &gt; pdflatex slony.tex<br>&gt;  &gt; pdflatex slony.tex<br>&gt;  &gt; pdflatex slony.tex<br>&gt;  &gt;<br>&gt;  &gt; Then the PDF
 file is generated.<br>&gt;  &gt;<br>&gt;  &gt; That&#39;s all.<br>&gt;  &gt;<br>&gt;  &gt;<br>&gt;  &gt; ------------------------------------------------------------------------<br>&gt;  &gt; *De :* Steve Singer &lt;<a href="mailto:ssinger@ca.afilias.info" target="_blank">ssinger@ca.afilias.info</a><br>

&gt; &lt;mailto:<a href="mailto:ssinger@ca.afilias.info" target="_blank">ssinger@ca.afilias.info</a>&gt;&gt;<br>&gt;  &gt; *À :* David TECHER &lt;<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a> &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt;&gt;<br>

&gt;  &gt; *Cc :* Devrim GÜNDÜZ &lt;<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a> &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;&gt;;<br>&gt; Slony Hackers<br>

&gt;  &gt; &lt;<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;&gt;<br>

&gt;  &gt; *Envoyé le :* Lundi 24 Octobre 2011 16h22<br>&gt;  &gt; *Objet :* Re: [Slony1-hackers] Re : Re : Slony 2.1.0 PDF Documentation<br>&gt;  &gt; available<br>&gt;  &gt;<br>&gt;  &gt; On 11-10-23 12:44 PM, David TECHER wrote:<br>

&gt;  &gt; &gt; If you are interested, the files used to generated the pdf are<br>&gt; joined to<br>&gt;  &gt; &gt; this mail.<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; slony.xml:<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; The file you&#39;ve got when you do<br>

&gt;  &gt;
 &gt;<br>&gt;  &gt; &gt; make slony.xml<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; I had to modify it manually.<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; slony.tex:<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; do<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; pdflatex slony.tex<br>

&gt;  &gt; &gt;<br>&gt;  &gt; &gt; Be sure to have the image &#39;complexenv.png&#39; in the same directory where<br>&gt;  &gt; &gt; the command is executed<br>&gt;  &gt;<br>&gt;  &gt; To include this in the -doc tar builds going forward I need to know what<br>

&gt;  &gt; commands to execute to build the PDF from the xml sources.<br>&gt;  &gt;<br>&gt;  &gt; $ cd doc/adminguide<br>&gt;  &gt; $ make slony.xml<br>&gt;  &gt;<br>&gt;  &gt; then what? Do I need to run<br>&gt;  &gt;<br>

&gt;  &gt; $ make slony.pdf<br>&gt;  &gt;<br>&gt;  &gt; or something else?<br>&gt;  &gt;<br>&gt;  &gt;
 &gt;<br>&gt;  &gt; &gt;<br>&gt; ------------------------------------------------------------------------<br>&gt;  &gt; &gt; *De :* David TECHER &lt;<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a><br>

&gt; &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt; &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a><br>&gt; &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt;&gt;&gt;<br>

&gt;  &gt; &gt; *À :* Devrim GÜNDÜZ &lt;<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a> &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;<br>&gt; &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a> &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;&gt;&gt;<br>

&gt;  &gt; &gt; *Cc :* Slony Hackers &lt;<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;<br>

&gt;  &gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;&gt;&gt;<br>

&gt;  &gt; &gt; *Envoyé le :* Dimanche 23 Octobre 2011 17h53<br>&gt;  &gt; &gt; *Objet :* [Slony1-hackers] Re :
 Slony 2.1.0 PDF Documentation available<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; Devrim,<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; I hope so.<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; Thanks for your mail.<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; David.<br>

&gt;  &gt; &gt;<br>&gt;  &gt; &gt;<br>&gt; ------------------------------------------------------------------------<br>&gt;  &gt; &gt; *De :* Devrim GÜNDÜZ &lt;<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a> &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;<br>

&gt; &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a> &lt;mailto:<a href="mailto:devrim@gunduz.org" target="_blank">devrim@gunduz.org</a>&gt;&gt;&gt;<br>&gt;  &gt; &gt; *À :* David TECHER &lt;<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a><br>

&gt; &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt; &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a><br>&gt; &lt;mailto:<a href="mailto:davidtecher@yahoo.fr" target="_blank">davidtecher@yahoo.fr</a>&gt;&gt;&gt;<br>

&gt;  &gt; &gt; *Cc :* Slony Hackers &lt;<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;<br>

&gt;  &gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:slony1-hackers@lists.slony.info" target="_blank">slony1-hackers@lists.slony.info</a>&gt;&gt;&gt;<br>

&gt;  &gt; &gt; *Envoyé le :* Samedi 22 Octobre 2011 10h42<br>&gt;  &gt; &gt; *Objet :* Re: [Slony1-hackers] Slony 2.1.0 PDF Documentation available<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; On Fri, 2011-10-21 at 23:50 +0100, David TECHER wrote:<br>

&gt;  &gt; &gt; &gt;<br>&gt;  &gt; &gt; &gt; The documentation is available at<br>&gt;  &gt; &gt; &gt; <a href="http://www.davidgis.fr/documentation/slony/2.1.0/pdf/slony-2.1.0.pdf" target="_blank">http://www.davidgis.fr/documentation/slony/2.1.0/pdf/slony-2.1.0.pdf</a><br>

&gt;  &gt; &gt; &gt;<br>&gt;  &gt; &gt; &gt; I did not attached the PDF to the mail (big file 1M even if<br>&gt;  &gt; &gt; &gt;
 compressed).<br>&gt;  &gt; &gt; &gt;<br>&gt;  &gt; &gt; &gt; Let me know if you want to put it on <a href="http://slony.info" target="_blank">slony.info</a> :)<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; Thanks for the work!<br>

&gt;  &gt; &gt;<br>&gt;  &gt; &gt; I really want to see it in <a href="http://slony.info" target="_blank">slony.info</a>, so that I can push this PDF<br>&gt; along<br>&gt;  &gt; &gt; with RPMs.<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; Regards,<br>

&gt;  &gt; &gt; --<br>&gt;  &gt; &gt; Devrim GÜNDÜZ<br>&gt;  &gt; &gt; Principal Systems Engineer @ EnterpriseDB: <a href="http://www.enterprisedb.com" target="_blank">http://www.enterprisedb.com</a><br>&gt;  &gt; &gt; PostgreSQL Danışmanı/Consultant, Red Hat Certified Engineer<br>

&gt;  &gt; &gt; Community: devrim~PostgreSQL.org, devrim.gunduz~<a href="http://linux.org.tr" target="_blank">linux.org.tr</a><br>&gt;  &gt; &gt; <a href="http://www.gunduz.org" target="_blank">http://www.gunduz.org</a> Twitter: <a href="http://twitter.com/devrimgunduz" target="_blank">http://twitter.com/devrimgunduz</a><br>

&gt;  &gt; &gt;<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; _______________________________________________<br>&gt;  &gt; &gt; Slony1-hackers mailing list<br>&gt;  &gt; &gt; <a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>

&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a>&gt;<br>&gt;  &gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>

&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a>&gt;&gt;<br>&gt;  &gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>

&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a>&gt;<br>&gt;  &gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>

&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a>&gt;&gt;&gt;<br>&gt;  &gt; &gt; <a href="http://lists.slony.info/mailman/listinfo/slony1-hackers" target="_blank">http://lists.slony.info/mailman/listinfo/slony1-hackers</a><br>

&gt;  &gt; &gt;<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt;<br>&gt;  &gt; &gt; _______________________________________________<br>&gt; 
 &gt; &gt; Slony1-hackers mailing list<br>&gt;  &gt; &gt; <a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a>&gt;<br>

&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>&gt; &lt;mailto:<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a>&gt;&gt;<br>

&gt;  &gt; &gt; <a href="http://lists.slony.info/mailman/listinfo/slony1-hackers" target="_blank">http://lists.slony.info/mailman/listinfo/slony1-hackers</a><br>&gt;  &gt;<br>&gt;  &gt;<br>&gt;  &gt;<br>&gt;<br>&gt;<br>&gt;<br>

<br><br><br></div></div></div></div><br>_______________________________________________<br>
Slony1-hackers mailing list<br>
<a href="mailto:Slony1-hackers@lists.slony.info" target="_blank">Slony1-hackers@lists.slony.info</a><br>
</div><a href="http://lists.slony.info/mailman/listinfo/slony1-hackers" target="_blank">http://lists.slony.info/mailman/listinfo/slony1-hackers</a><br>
<br></blockquote></div>
</div>