[PATCH xserver 0/5] using util-macros to manage docs targets

Jeremy Huddleston jeremyhu at freedesktop.org
Sat Feb 6 10:38:30 PST 2010


Series Reviewed-by: Jeremy Huddleston <jeremyhu at apple.com>

The only reservation I have is wrt the txt->text renaming.  The issue that I can see is when the generated file is present and the user tries to checkout a version with the file in git.  Is this renaming really the best way to handle this situation?  I'm sure this problem has come up before for other repositories.

On Feb 6, 2010, at 06:37, Gaetan Nadon wrote:

> Summary of visible external functional changes:
> 
> * --enable-builddocs replaced with generic util-macros --enable-devel-docs
> * documentation now built by default
> * dmx/doc git files dmx.txt and scaled.txt have renamed extension to .text
> * message alerting builder when tarball cannot be created due to missing doxygen tool
> 
> See individual patches for details and rationales.
> 
> * all the rules under which a tarball may or may not be created have not changed.
> * the content of the tarball has not changed. (save for .text extension)
> * the documents retain their classifcation as "development" documents
> 
> Gaetan Nadon (5):
>  config: use new XORG_ENABLE_DEVEL_DOCS util-macro
>  doc: update .gitignore for dmx and xfree86 docs
>  dmx/doc: resolve conflict between generated files also in git
>  config: enable building documentation by default
>  dmx/doc: alert builder when a tarball cannot be created
> 
> configure.ac                    |   14 +-
> hw/dmx/Makefile.am              |    6 +-
> hw/dmx/doc/.gitignore           |    8 +
> hw/dmx/doc/Makefile.am          |   28 +-
> hw/dmx/doc/dmx.text             | 2989 +++++++++++++++++++++++++++++++++++++++
> hw/dmx/doc/dmx.txt              | 2989 ---------------------------------------
> hw/dmx/doc/scaled.text          |  579 ++++++++
> hw/dmx/doc/scaled.txt           |  579 --------
> hw/xfree86/doc/Makefile.am      |    4 -
> hw/xfree86/doc/sgml/.gitignore  |    5 +
> hw/xfree86/doc/sgml/Makefile.am |    8 +-
> 11 files changed, 3616 insertions(+), 3593 deletions(-)
> create mode 100644 hw/dmx/doc/dmx.text
> delete mode 100644 hw/dmx/doc/dmx.txt
> create mode 100644 hw/dmx/doc/scaled.text
> delete mode 100644 hw/dmx/doc/scaled.txt
> create mode 100644 hw/xfree86/doc/sgml/.gitignore
> 
> _______________________________________________
> xorg-devel mailing list
> xorg-devel at lists.x.org
> http://lists.x.org/mailman/listinfo/xorg-devel



More information about the xorg-devel mailing list