Matthijs Kooijman
2015-04-30 08:55:37 UTC
---
** [bugs:#280] Confusing (old?) odtwriter docs and code in the sandbox**
**Status:** open
**Group:** Default
**Created:** Thu Apr 30, 2015 08:55 AM UTC by Matthijs Kooijman
**Last Updated:** Thu Apr 30, 2015 08:55 AM UTC
**Owner:** nobody
I recently stumbled upon odtwriter/rst2odt, which is exactly the tool I've been looking for for a while. However, googling for "odtwriter" returns two pieces of documentation:
http://docutils.sourceforge.net/docs/user/odt.html
http://docutils.sourceforge.net/sandbox/OpenDocument/docs/odtwriter.html
Initially, I've been looking at the sandbox version of the docs, since it has a more recent data (2013 vs 2012). However, I've since learnt that there is an rst2odt included with docutils, which is documented by the first link above.
I suspect that odtwriter originated in the sandbox and was later included the main source, so the sandbox version is now deprecated.
To prevent further confusion, perhaps the sandbox version should be removed? It might be useful to keep sandbox/OpenDocument/docs/odtwriter.html and perhaps also sandbox/OpenDocument/README.html and have them contain a link to the new documentation (since I think these urls might have some incoming links still).
---
Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/bugs/
To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
** [bugs:#280] Confusing (old?) odtwriter docs and code in the sandbox**
**Status:** open
**Group:** Default
**Created:** Thu Apr 30, 2015 08:55 AM UTC by Matthijs Kooijman
**Last Updated:** Thu Apr 30, 2015 08:55 AM UTC
**Owner:** nobody
I recently stumbled upon odtwriter/rst2odt, which is exactly the tool I've been looking for for a while. However, googling for "odtwriter" returns two pieces of documentation:
http://docutils.sourceforge.net/docs/user/odt.html
http://docutils.sourceforge.net/sandbox/OpenDocument/docs/odtwriter.html
Initially, I've been looking at the sandbox version of the docs, since it has a more recent data (2013 vs 2012). However, I've since learnt that there is an rst2odt included with docutils, which is documented by the first link above.
I suspect that odtwriter originated in the sandbox and was later included the main source, so the sandbox version is now deprecated.
To prevent further confusion, perhaps the sandbox version should be removed? It might be useful to keep sandbox/OpenDocument/docs/odtwriter.html and perhaps also sandbox/OpenDocument/README.html and have them contain a link to the new documentation (since I think these urls might have some incoming links still).
---
Sent from sourceforge.net because docutils-***@lists.sourceforge.net is subscribed to https://sourceforge.net/p/docutils/bugs/
To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.