First off I apologize for not fully reading this thread, I've been on
vacation and there's just a pile of email waiting. If this question has
been resolved just point me at the relevant discussions.
But _why_ are we reverting back to docbook? A few years ago we moved to
wiki to get _away_ from docbook. The thought was to lower the barrier
to entry for new contributors, just put all the docs on a wiki. And I
think this worked pretty well, we have far more content than we did before.
I concede that without a solid maintainer it's spiraled a bit out of
control. But wiki lets you do pdf export and the like, so I'm not sure
I understand the advantages of docbook? And the disadvantages are clear
and proven for us, we get less documentation contributions when users
have to check out and commit on svn just to add a line or two to the docs.
And I fully support more documention, and if Adrian is super motivated
and will only work in docbook, but will make nice, complete guides on
his own, that's fine. Just wanted to raise the fact that we tried
docbook before. It was a bitch to work with, we ended up having all
these files to automatically transform from docbook to html, ect. and it
ended up being too much overhead.
best regards,
Chris
Richard Gould wrote:
I have updated the config file attached to the Subversion page.
http://docs.codehaus.org/display/GEOT/Subversion
Richard
On Tue, 2006-22-08 at 18:17 +0200, Martin Desruisseaux wrote:
Adrian Custer a écrit :
I've committed the skeleton of the docbook doc into gt/doc/C/. There's a
00_Readme.text file that shows how I'm using docbook. There are two
printed manuals in gt/doc/C/output/. geotools.ps is the output generated
by yelp that shows how an elegant .xsl transform should behave.
geotools.pdf is the FOP based system that shows a generic PDF output.
Can I update the *.xml SVN properties? More specifically, adding:
svn:mime-type=text/xml
svn:eol-style=native
svn:keywords=Id URL
Reminder: in order to get those properties set automatically to every files commited to SVN, I
suggest that every developpers edit their "~\Application Data\Subversion\config" file (if not
already done) and add the content of attached file (or something similar) close to the end of their
"config" file.
Martin.
plain text document attachment (config.txt)
[miscellany]
global-ignores = *.class *.jar *.o *.lo *.so *.la .*.rej *.rej .* .*~ *~ .#* #*#
enable-auto-props = yes
[auto-props]
*.java = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.sql = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.c = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.cpp = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.h = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.txt = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.tex = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.sgml = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.properties = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords=Id URL
*.xml = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords=Id URL
*.form = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords=Id URL
*.classpath = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords=Id URL
*.project = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords=Id URL
*.sld = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords=Id URL
*.gml = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords=Id URL
*.xsl = svn:mime-type=text/xsl;svn:eol-style=native;svn:keywords=Id URL
*.html = svn:mime-type=text/html;svn:eol-style=native;svn:keywords=Id URL
*.css = svn:mime-type=text/css;svn:eol-style=native;svn:keywords=Id URL
*.dsp = svn:eol-style=CRLF
*.bat = svn:eol-style=CRLF
*.dsw = svn:eol-style=CRLF
*.sh = svn:eol-style=native;svn:executable;svn:keywords=Id URL
*.bmp = svn:mime-type=image/bmp
*.png = svn:mime-type=image/png
*.jpg = svn:mime-type=image/jpeg
*.jpeg = svn:mime-type=image/jpeg
*.gif = svn:mime-type=image/gif
*.tif = svn:mime-type=image/tiff
*.tiff = svn:mime-type=image/tiff
*.zip = svn:mime-type=application/zip
*.sxw = svn:mime-type=application/zip
*.sxc = svn:mime-type=application/zip
*.sxi = svn:mime-type=application/zip
*.utf = svn:mime-type=application/octet-stream
*.ttf = svn:mime-type=application/octet-stream
*.shp = svn:mime-type=application/octet-stream
*.shx = svn:mime-type=application/octet-stream
*.dbf = svn:mime-type=application/octet-stream
*.mif = svn:mime-type=application/octet-stream
*.mid = svn:mime-type=application/octet-stream
*.wld = svn:mime-type=application/octet-stream
Makefile = svn:mime-type=text/plain;svn:eol-style=native
README = svn:mime-type=text/plain;svn:eol-style=native
INSTALL = svn:mime-type=text/plain;svn:eol-style=native
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________ Geotools-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-devel
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Geotools-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-devel
!DSPAM:1003,44edd6ac24171365099012!
--
Chris Holmes
The Open Planning Project
http://topp.openplans.org
begin:vcard
fn:Chris Holmes
n:Holmes;Chris
org:The Open Planning Project
adr:;;377 Broadway, 11th Floor;New York;NY;10013;USA
email;internet:[EMAIL PROTECTED]
title:VP, Strategic Development
x-mozilla-html:FALSE
url:http://topp.openplans.org
version:2.1
end:vcard
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Geotools-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-devel
