rest2web-develop

[Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[Andreas P. <ap...@gm...>]

Package: rest2web-doc
Version: 0.5.0~beta~svn-r210-1
Severity: normal

Hi,

currently the html dir installed by this packages only contains the
source rest files of the documentation, but no html. This is a problem
for anybody not familiar with rest2web, because there's also no README
explaining how to or config file for generating them.

I tried to create a minimal config file, but it bails out on the
config_file.text at line 47. This might be a separate (upstream) bug but
I can't be sure, because I have no idea wether the config I have is
correct.

Andreas

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (990, 'unstable'), (500, 'experimental'), (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.17.11
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)

-- no debconf information

Re: [Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[Michael F. <fuz...@vo...>]

Andreas Pakulat wrote:
> Package: rest2web-doc
> Version: 0.5.0~beta~svn-r210-1
> Severity: normal
>
> Hi,
>
> currently the html dir installed by this packages only contains the
> source rest files of the documentation, but no html. This is a problem
> for anybody not familiar with rest2web, because there's also no README
> explaining how to or config file for generating them.
>
> I tried to create a minimal config file, but it bails out on the
> config_file.text at line 47. This might be a separate (upstream) bug but
> I can't be sure, because I have no idea wether the config I have is
> correct.
>   
The HTML version of the documentation *ought* to be 'buildable' for any 
distribution, just by running r2w.py and the supplied example 'r2w.ini' 
configuration file.

If it fails to build, then it is a bug.

I always check this before doing official releases, as I use the 
documentation from the package for the online documentation.

Debian is currently tracking subversion, and it looks like the 
documentation isn't currently buildable from SVN - oops.

This will be fixed shortly, my apologies.

Fuzzyman
http://www.voidspace.org.uk/python/index.shtml


> Andreas
>
> -- System Information:
> Debian Release: testing/unstable
>   APT prefers unstable
>   APT policy: (990, 'unstable'), (500, 'experimental'), (500, 'testing'), (500, 'stable')
> Architecture: i386 (i686)
> Shell:  /bin/sh linked to /bin/bash
> Kernel: Linux 2.6.17.11
> Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
>
> -- no debconf information
>
>
>
> -------------------------------------------------------------------------
> 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
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>
>   

Re: [Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[Andreas P. <ap...@gm...>]

On 12.09.06 22:59:18, Michael Foord wrote:
> Andreas Pakulat wrote:
> >Package: rest2web-doc
> >Version: 0.5.0~beta~svn-r210-1
> >Severity: normal
> >
> >currently the html dir installed by this packages only contains the
> >source rest files of the documentation, but no html. This is a problem
> >for anybody not familiar with rest2web, because there's also no README
> >explaining how to or config file for generating them.
> >
> >I tried to create a minimal config file, but it bails out on the
> >config_file.text at line 47. This might be a separate (upstream) bug but
> >I can't be sure, because I have no idea wether the config I have is
> >correct.
> > =20
> The HTML version of the documentation *ought* to be 'buildable' for any=
=20
> distribution, just by running r2w.py and the supplied example 'r2w.ini'=
=20
> configuration file.

Hmm, then the debian package should install this r2w.ini and provide a
README.Debian on how to build the html documentation. Thus I'm cc'ing
the debian bugreport.

Thanks for notifying me.

Andreas

--=20
You are destined to become the commandant of the fighting men of the
department of transportation.

Re: [Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[Michael F. <fuz...@vo...>]

Andreas Pakulat wrote:
> On 12.09.06 22:59:18, Michael Foord wrote:
>   
>> Andreas Pakulat wrote:
>>     
>>> Package: rest2web-doc
>>> Version: 0.5.0~beta~svn-r210-1
>>> Severity: normal
>>>
>>> currently the html dir installed by this packages only contains the
>>> source rest files of the documentation, but no html. This is a problem
>>> for anybody not familiar with rest2web, because there's also no README
>>> explaining how to or config file for generating them.
>>>
>>> I tried to create a minimal config file, but it bails out on the
>>> config_file.text at line 47. This might be a separate (upstream) bug but
>>> I can't be sure, because I have no idea wether the config I have is
>>> correct.
>>>  
>>>       
>> The HTML version of the documentation *ought* to be 'buildable' for any 
>> distribution, just by running r2w.py and the supplied example 'r2w.ini' 
>> configuration file.
>>     
>
> Hmm, then the debian package should install this r2w.ini and provide a
> README.Debian on how to build the html documentation. Thus I'm cc'ing
> the debian bugreport.
>
> Thanks for notifying me.
>   
Understood.

Martin - if I produce a README, can you handle packaging the default 
r2w.ini along with the documentation, or would it be better to include 
pre-built HTML with the package ?

Michael
http://www.voidspace.org.uk/python/index.shtml

> Andreas
>
>   
> ------------------------------------------------------------------------
>
> -------------------------------------------------------------------------
> 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
> ------------------------------------------------------------------------
>
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   

Re: [Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[martin f k. <ma...@ma...>]

also sprach Michael Foord <fuz...@vo...> [2006.09.13.0029 +020=
0]:
> Martin - if I produce a README, can you handle packaging the default=20
> r2w.ini along with the documentation, or would it be better to include=20
> pre-built HTML with the package ?

I think we should include the pre-built HTML alongside the sources.

--=20
martin;              (greetings from the heart of the sun.)
  \____ echo mailto: !#^."<*>"|tr "<*> mailto:" net@madduck
=20
spamtraps: mad...@ma...
=20
"for art to exist, for any sort of aesthetic activity or perception to
 exist, a certain physiological precondition is indispensable:
 intoxication."
                                                -- friedrich nietzsche

[Rest2web-develop] Bug#386949: rest2web-doc: please include html docs or provide configuration that can build them

[martin f k. <ma...@de...>]

Version: 0.5.0.svn-r227-1

This bug has been fixed in the current version.

--=20
 .''`.   martin f. krafft <ma...@de...>
: :'  :  proud Debian developer, author, administrator, and user
`. `'`   http://people.debian.org/~madduck - http://debiansystem.info
  `-  Debian - when you have better things to do than fixing systems

[Rest2web-develop] Bug#386949: marked as done (rest2web-doc: please include html docs or provide configuration that can build them)

[<ow...@bu...>]

Your message dated Wed, 7 Mar 2007 14:15:25 +0000
with message-id <200...@la...>
and subject line Bug#386949: rest2web-doc: please include html docs or prov=
ide configuration that can build them
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)