Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id 15FA7632D8C for ; Fri, 9 Jul 2010 23:46:38 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia, port 10024) with ESMTP id 70348-02 for ; Sat, 10 Jul 2010 02:46:28 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from momjian.us (momjian.us [70.90.9.53]) by mail.postgresql.org (Postfix) with ESMTP id 4B18D63242D for ; Fri, 9 Jul 2010 23:46:30 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id o6A2kQ811156; Fri, 9 Jul 2010 22:46:26 -0400 (EDT) From: Bruce Momjian Message-Id: <201007100246.o6A2kQ811156@momjian.us> Subject: Re: Documentation and explanatory diagrams In-Reply-To: <1278728731-sup-888@alvh.no-ip.org> To: Alvaro Herrera Date: Fri, 9 Jul 2010 22:46:26 -0400 (EDT) CC: Rafael Martinez , Robert Haas , pgsql-docs X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="ELM1278729986-26654-0_" Content-Transfer-Encoding: 7bit X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=0.543 tagged_above=-5 required=5 tests=BAYES_05=-0.5, DC_IMAGE_SPAM_HTML=0.81, DC_IMAGE_SPAM_TEXT=0.242, DC_PNG_UNO_LARGO=0.001, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201007/90 X-Sequence-Number: 5746 --ELM1278729986-26654-0_ Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" Alvaro Herrera wrote: > Excerpts from Bruce Momjian's message of vie jul 09 20:01:55 -0400 2010: > > > Where are we on this? Application? dia? xfig? Number of colors? Once > > we decide these items, we can start adding diagrams. > > I think the first step is defining the source format. The proposed > patch uses the dia XML source format, but this is said to have some > drawbacks (namely: the source is too verbose, the generated png is too > bloated, and only one tool to handle it). SVG was also proposed as an > alternative, but there wasn't much discussion about it. And finally we > have xfig. > > So what is it? > > Maybe we could have diagrams generated by different tools; e.g. we could > use GraphViz for some things. OK, all the images on my presentations page are from xfig, and the representative file sizes are as below: 1092 query_ssl.fig 4370 query_ssl.png PNG image attached. What I like about xfig is that I can export EPS and embed those in PDF files as _raster_ images. Not sure we can use those in our PDFs though. I assume Dia has more image style options than xfig. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + None of us is going to be here forever. + --ELM1278729986-26654-0_ Content-Transfer-Encoding: base64 Content-Type: image/png Content-Disposition: inline; filename="/rtmp/mime.11004/query_ssl.png" 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 q9VcdsyfC/HF9tyYj50269pcHVPWpGzt/Egaqc31mhK1efM58lxyvlm/za9yVbOK4ct/+YM/5JJf PBR7TXlJ1nFBnkeb1yHUVR0ZX+otyMP4Ey7a/LSqk9ig8ed6/SI5kPTE8ZHn5iRcsjnp/2Tp3caf u/Rq48+th2BufInjZHbVMOBbrrK12O8KH+RChWYX5RZ8fCi59SXj83/BWP5PWF4qy4Xn1RWej62k dR1ZMhcNt77xc0bwPBjLv7xmz4XlwvNiaZ6/a/58g/H5BirGvWB8vn6bI38Onn+T2Jlo19k8Rb5l cX+uAyKNXGLUcugYf7TNhwf1nZfochhCbQzSThzSzIHo5pfjudhceC5BeVXfYPM0SnQ6ynfcpEuO mReXNSkYHb9nKUqXlmSJAAnpKVlYHrKNhXSoRcS3+vP15s8P4VA3PL/B5tQdd7Z/2jl1aj8zYpOJ yVJLMbfO07Kn9iBzNiY98pwQt/TZXOcSWq6F2+G5TDbUdIgMMHWCFqcJpMeWxn7LEGguy2xuaRo7 eOyQP+dzd64jfHUKYl0b/Kfxug3jM/Mx0eaW9dKWbFkBdTN6n4b1jm14ao7GcgHg+ZzisnN/TXx/ 3IL4HPE5roem+eb74oDroY/l+SHso+G//JdmzTXDGMDzpee3WL5cpqAXMvt8HzC/ZWGeC8OV53LN KLdMOniO+S2IW8BzxOfgeUcWXx8Kf74s0bex+Bzr/dcbny9ZvwV1LVC/5eX9+TvaHDx/u/gcPAfP 4c/Bc/D8deJz8Bw8hz8Hz8FzxOfgOXgOfw6eQxCfg+fw5/Dn4Dnic8Tn4Dn8Ofw5eI74HAKew5+D 5+A54nPwHDyHPwfPwXPE5+A5/Dn8OXiO+BzxOXgOfw5/Dp4jPoeFwXP4c/AcPEd8Dp6D5/Dn4Dl4 jvgcPIfAn4PniM8Rn4Pn8Ofw5+A54nPE5+A5/DkEPEd8Dp6D5/Dn4Dl4jvgcPAfP4c/Bc0j2c8n4 /BP27ZOPJXkOmw8QfTl/DpM/nOmf8OaD4n4uwfJPB8tCIBAIBAKBQCDbkP8BLbZ5wY3AbtkAAAA8 dEVYdFNvZnR3YXJlAEAoIylJbWFnZU1hZ2ljayAzLjguOSA5Ny8wOC8xNSBjcmlzdHlAc3ltcGF0 aWNvLm9yZyStmh4AAAAqdEVYdFNpZ25hdHVyZQAzMTQ0ZjJmODMzNjBkYWVjY2Y2NjdhZDlkMGU1 NTZkNb7CSfAAAAAwdEVYdENvbW1lbnQAICBJbXBvcnRlZCBmcm9tIFBORyBpbWFnZTogcXVlcnlf c3NsLnBuZ+RzelsAAAAASUVORK5CYII= --ELM1278729986-26654-0_--