svn pre-commit problem and long file names

I am trying to submit a copy of the GIL documentation into main. The documentation consists of hundreds of files auto-generated by Doxygen. Many of them have longer names than 31 characters, and the svn pre-commit hook fails because of that. I couldn't figure a way to make Doxygen generate smaller file names and it would be impossible to manually shorten the names of hundreds of files every time we need to generate the files. Can we lift the file name length restriction? Any other solutions? Thanks, Lubomir

I guess you could always try: http://www.softpedia.com/get/System/ File-Management/Shorts.shtml I haven't used it myself. However, first you will need to decide whether generated docs should be submitted to the svn. There was a recent thread about that. If that is your primary library documentation, then how it was generated is irrelevant. But if you intend to update it (as is the whole point of doxygen), I think it would be better to post it somewhere else public but owned by you (not in the svn) and put in a relocate in the index.html, with the option for the user to generate the docs themselves and overwrite the index.html in their private copy (put in some safeguards to prevent them from checking in inadvertently). HTH, --HB On Nov 11, 2007, at 12:15 PM, Lubomir Bourdev wrote:
I am trying to submit a copy of the GIL documentation into main. The documentation consists of hundreds of files auto-generated by Doxygen. Many of them have longer names than 31 characters, and the svn pre-commit hook fails because of that.
I couldn't figure a way to make Doxygen generate smaller file names and it would be impossible to manually shorten the names of hundreds of files every time we need to generate the files. Can we lift the file name length restriction? Any other solutions?
Thanks, Lubomir
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/ listinfo.cgi/boost

At 9:15 AM -0800 11/11/07, Lubomir Bourdev wrote:
I couldn't figure a way to make Doxygen generate smaller file names
According to the doxygen manual, the configuration option SHORT_NAMES might help. "If set to "YES" doxygen will generate much shorter (but less readable) file names." Although from the description I'm going to guess that it might be trying for 8.3 filenames. And I don't know if the same names get generated from one run to another (I would hope so, but I've never tried this option myself).

-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Lubomir Bourdev Sent: 11 November 2007 17:16 To: boost@lists.boost.org Subject: [boost] svn pre-commit problem and long file names
I am trying to submit a copy of the GIL documentation into main. The documentation consists of hundreds of files auto-generated by Doxygen. Many of them have longer names than 31 characters, and the svn pre-commit hook fails because of that.
I couldn't figure a way to make Doxygen generate smaller file names and it would be impossible to manually shorten the names of hundreds of files every time we need to generate the files. Can we lift the file name length restriction? Any other solutions?
Reluctantly, I'm coming the view that we should relax the restrictions. IIRC the rationale was based mainly on the wish to be able to burn CDs. However increasingly CD burning software can produce CDs that are less restricted, certainly up to 64 chars using ISO 9660 and Joliet extensions. For example Nero certainly allowed this restrictions to be eased (and more nesting depth too). Windows appears to require short filename for bootable CDs, but I am not sure about other files. Should we start a new thread to discuss this when 1.35 is out? Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow@hetp.u-net.com

Paul A Bristow wrote:
I couldn't figure a way to make Doxygen generate smaller file names and it would be impossible to manually shorten the names of hundreds of files every time we need to generate the files. Can we lift the file name length restriction? Any other solutions?
Try short names option: http://www.stack.nl/~dimitri/doxygen/config.html#cfg_short_names
Reluctantly, I'm coming the view that we should relax the restrictions.
IIRC the rationale was based mainly on the wish to be able to burn CDs. However increasingly CD burning software can produce CDs that are less restricted, certainly up to 64 chars using ISO 9660 and Joliet extensions. For example Nero certainly allowed this restrictions to be eased (and more nesting depth too).
Windows appears to require short filename for bootable CDs, but I am not sure about other files.
Should we start a new thread to discuss this when 1.35 is out?
I suppose, but I thought we were already taking into account whats allowed by the extensions in the policy? I still want to be able to burn boost on a cd... Jeff

-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Jeff Garland Sent: 12 November 2007 12:44 To: boost@lists.boost.org Subject: Re: [boost] svn pre-commit problem and long file names
Paul A Bristow wrote:
Reluctantly, I'm coming the view that we should relax the restrictions.
Should we start a new thread to discuss this when 1.35 is out?
I suppose, but I thought we were already taking into account whats allowed by the extensions in the policy? I still want to be able to burn boost on a cd...
I'm not well enough informed on this to comment. Is anyone 'fully informed' on the implications of this, on the various platforms? Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow@hetp.u-net.com

Paul A Bristow wrote:
On Behalf Of Jeff Garland
Paul A Bristow wrote:
Reluctantly, I'm coming the view that we should relax the restrictions. Should we start a new thread to discuss this when 1.35 is out? I suppose, but I thought we were already taking into account whats allowed by the extensions in the policy? I still want to be able to burn boost on a cd...
I'm not well enough informed on this to comment. Is anyone 'fully informed' on the implications of this, on the various platforms?
Well I don't know about every platform. But MacOS still has the 31 char limit under most common circumstances. -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo

Hi there I try to compile the boost-libs within WinXP 64 but without any success. There aren't any precompiled libraries as for x32? Bjam doesn't have this option, too. So is there anywhere a manual how to compile the 1.3..x boost libraries within WinXP and MSVC8? We use the cl- and sometimes the ippc9.1-compiler. Best, SirAnn

Lubomir Bourdev wrote:
I am trying to submit a copy of the GIL documentation into main. The documentation consists of hundreds of files auto-generated by Doxygen. Many of them have longer names than 31 characters, and the svn pre-commit hook fails because of that. [...skipped...]
Paul Bristow wrote:
Reluctantly, I'm coming the view that we should relax the restrictions. [...skipped...] Should we start a new thread to discuss this when 1.35 is out?
This is needed for 1.35 if we want the Doxygen documentation of GIL into Boost. Right now the design guide and tutorial are in libs/gil/doc, but other resources, such as Doxygen documentation and video tutorial are links to the ASL web site. Perhaps this is a good solution for 1.35. We certainly don't want to put everything into Boost - adding the video will make 1.35 very big. Lubomir
participants (7)
-
Hervé Brönnimann
-
Jeff Garland
-
Kim Barrett
-
Lubomir Bourdev
-
Paul A Bristow
-
Rene Rivera
-
Sören Freudiger