[ 
http://jira.codehaus.org/browse/GEOT-3587?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Ben Caradoc-Davies reopened GEOT-3587:
--------------------------------------


Michael,

your commit in r37204 has broken every page that includes or references another 
file by its old .txt name. This has broken the geotools-trunk-docs build:
http://hudson.opengeo.org/hudson/job/geotools-trunk-docs/817/console

Here is a quick find+grep (some false positives):
{code}
$ find . -name "*.rst" -exec grep -H '.txt' {} \;
./developer/guide/conventions/code/url.rst:file.txt                            
file:file.txt
./developer/guide/conventions/code/url.rst:C:\direct with a space\file.txt     
file://C:/directory%20with%20a%20space/file.txt
./developer/guide/conventions/code/url.rst:\\host.org\share\directory\file.txt 
file://///host.org/share/directory/file.txt
./developer/guide/conventions/profile.rst:At the end of the run you'll find a 
java.hprof.txt file that can be opened with HPJMeter.
./developer/guide/conventions/profile.rst:At the end of the run you'll find a 
java.hprof.txt file that can be opened with HPJMeter.
./developer/guide/procedures/check.rst:* Passes IP check documented in 
review.txt file, basically has correct headers
./developer/guide/building/maven/build.rst:     22/10/2006  09:11 AM            
 3,705 README.txt
./developer/guide/building/maven/build.rst:   
C:\java\geotools\trunk\modules\library\metadata\target\surefire-reports>more 
*RangeSetTest.txt
./developer/guide/building/maven/build.rst:   
C:\java\geotools\trunk\modules\library\render\target\surefire-reports>more 
*GridCoverageRendererTest.txt
./developer/guide/docs/reference.rst:* module/index.txt
./developer/guide/docs/reference.rst:* module/faq.txt (frequently asked 
questions; included in overall geotools faq)
./developer/guide/docs/reference.rst:* module/foo.txt
./developer/guide/docs/reference.rst:* module/bar.txt
./developer/guide/docs/reference.rst:1. Create a faq.txt page similar to the 
example below::
./developer/guide/docs/reference.rst:2. Update the root faq.txt to include your 
new page::
./developer/guide/docs/reference.rst:        .. include:: 
/unsupported/name/faq.txt
./developer/guide/docs/tutorial.rst:        .. include:: <isonum.txt>
./user/tutorial/raster/image.rst:.. include:: <isonum.txt>
./user/tutorial/map/style.rst:.. include:: <isonum.txt>
./user/tutorial/filter/query.rst:.. include:: <isonum.txt>
./user/library/referencing/internal.rst:  (The DatumAliasesTable.txt file 
inside gt-referencing has an entry for "North American Datum 1927").
./user/library/referencing/crs.rst:To parse WKT please use the CRS.parseWKT( 
txt ) method::
./user/library/coverage/jdbc/prepare.rst:  In this situation you have to create 
a file listing all the tif files with absolute path names (Lets call it 
tilelist.txt ) 
./user/library/coverage/jdbc/prepare.rst:    gdal_retile.py -levels 3  -ps 512 
512 -targetDir /tmp/test --optfile tilelist.txt
./user/library/coverage/jdbc/prepare.rst:    gdal_retile.py -levels 3  -ps 512 
512 -csv index.csv -targetDir /tmp/test --optfile tilelist.txt
./user/library/coverage/jdbc/prepare.rst:    gdal_retile.py -levels 3  -ps 512 
512 -tileIndex index.shp -tileIndexField LOCATION -targetDir /tmp/test 
--optfile tilelist.txt
./user/library/coverage/jdbc/prepare.rst:    gdal_retile.py -levels 3  -ps 512 
512 -co "WORLDFILE=YES" -targetDir /tmp/test --optfile tilelist.txt
./user/library/internal/integration.rst:jar for a META-INF/services/\*.txt 
files. This works out of the box when all jars are loaded via the
./user/faq.rst:.. include:: /welcome/faq.txt
./user/faq.rst:.. include:: /library/opengis/faq.txt
./user/faq.rst:.. include:: /library/jts/faq.txt
./user/faq.rst:.. include:: /library/api/faq.txt
./user/faq.rst:.. include:: /library/metadata/faq.txt
./user/faq.rst:.. include:: /library/referencing/faq.txt
./user/faq.rst:.. include:: /library/coverage/faq.txt
./user/faq.rst:.. include:: /library/main/faq.txt
./user/faq.rst:.. include:: /library/jdbc/faq.txt
./user/faq.rst:.. include:: /library/cql/faq.txt
./user/faq.rst:.. include:: /library/xml/faq.txt
./user/faq.rst:.. include:: /library/render/faq.txt
./user/faq.rst:.. include:: /extension/brewer/faq.txt
./user/faq.rst:.. include:: /extension/wms/faq.txt
./user/faq.rst:.. include:: /unsupported/swing/faq.txt
{code}

> Use .rst extension for all sphinx source files
> ----------------------------------------------
>
>                 Key: GEOT-3587
>                 URL: http://jira.codehaus.org/browse/GEOT-3587
>             Project: GeoTools
>          Issue Type: Task
>          Components: doc
>            Reporter: Michael Bedward
>            Assignee: Michael Bedward
>             Fix For: 2.7.2, 8.0-M1
>
>
> Jody used .txt because it was favoured by the software he used to port the 
> docs from the wiki. Unless anyone objects we can now swap back to .rst to 
> make it easier for syntax-aware editors.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

------------------------------------------------------------------------------
Achieve unprecedented app performance and reliability
What every C/C++ and Fortran developer should know.
Learn how Intel has extended the reach of its next-generation tools
to help boost performance applications - inlcuding clusters.
http://p.sf.net/sfu/intel-dev2devmay
_______________________________________________
Geotools-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-devel

Reply via email to