Re: [Documentation] Use doxygen or another tool to generate a documentation ?
hoi :) On Sun, Aug 21, 2005 at 08:32:42PM +0200, Stephane Wirtel wrote: > Martin, your patch works for the htmldocs target, but not for the > pdfdocs, I think there is a bug in a latex package. I don't know which > one, but it's the same error. yes, some pdfdocs are broken and I haven't found the cause yet. I guess we have to ditch xmlto, at least for PDF/PS. -- Martin Waitz signature.asc Description: Digital signature
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
hoi :) On Sun, Aug 21, 2005 at 08:32:42PM +0200, Stephane Wirtel wrote: Martin, your patch works for the htmldocs target, but not for the pdfdocs, I think there is a bug in a latex package. I don't know which one, but it's the same error. yes, some pdfdocs are broken and I haven't found the cause yet. I guess we have to ditch xmlto, at least for PDF/PS. -- Martin Waitz signature.asc Description: Digital signature
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
> On Sat, Aug 20, 2005 at 07:37:06PM +0200, Sam Ravnborg wrote: > > > In make_docs.log.tar.bz2, you can find log files from make htmldocs, > > > make psdocs and make pdfdocs. > > > > From your log-files I could not see what went wrong. It seems to be > > error in the generated files. > > kerneldoc could not understand a macro definition. > > please try > http://tali.admingilde.org/patches/linux-docbook/docbook-fixes.patch Martin, your patch works for the htmldocs target, but not for the pdfdocs, I think there is a bug in a latex package. I don't know which one, but it's the same error. Thanks for your patch, Stephane -- Stephane Wirtel <[EMAIL PROTECTED]> <[EMAIL PROTECTED]> - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
hoi :) On Sat, Aug 20, 2005 at 07:37:06PM +0200, Sam Ravnborg wrote: > > In make_docs.log.tar.bz2, you can find log files from make htmldocs, > > make psdocs and make pdfdocs. > > From your log-files I could not see what went wrong. It seems to be > error in the generated files. kerneldoc could not understand a macro definition. please try http://tali.admingilde.org/patches/linux-docbook/docbook-fixes.patch -- Martin Waitz signature.asc Description: Digital signature
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Le Saturday 20 August 2005 a 19:08, Sam Ravnborg ecrivait: > On Sat, Aug 20, 2005 at 11:19:41AM +0200, Stephane Wirtel wrote: > > Le Saturday 20 August 2005 a 09:08, Sam Ravnborg ecrivait: > > > > > > > > Ok, with scripts/kernel-doc, I can produce some html files containing > > > > the functions' documentation. > > > > > > > > make pdfdocs or others targets don't work :| > > > > > > You probarly need some additional packages. > > > But it's not easy to help you with no log of what happened. > > Yes, sorry, > > > > Kernel : 2.6.12 from the git repository of Linus. > > > > In make_docs.log.tar.bz2, you can find log files from make htmldocs, > > make psdocs and make pdfdocs. > > From your log-files I could not see what went wrong. It seems to be > error in the generated files. > Maybe Martin can help - Martin? No news from Martin, Sam, Could you generate the documentation in PDF format, and send me ? Thanks, Stephane -- Stephane Wirtel <[EMAIL PROTECTED]> <[EMAIL PROTECTED]> - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Le Saturday 20 August 2005 a 19:08, Sam Ravnborg ecrivait: On Sat, Aug 20, 2005 at 11:19:41AM +0200, Stephane Wirtel wrote: Le Saturday 20 August 2005 a 09:08, Sam Ravnborg ecrivait: Ok, with scripts/kernel-doc, I can produce some html files containing the functions' documentation. make pdfdocs or others targets don't work :| You probarly need some additional packages. But it's not easy to help you with no log of what happened. Yes, sorry, Kernel : 2.6.12 from the git repository of Linus. In make_docs.log.tar.bz2, you can find log files from make htmldocs, make psdocs and make pdfdocs. From your log-files I could not see what went wrong. It seems to be error in the generated files. Maybe Martin can help - Martin? No news from Martin, Sam, Could you generate the documentation in PDF format, and send me ? Thanks, Stephane -- Stephane Wirtel [EMAIL PROTECTED] [EMAIL PROTECTED] - To unsubscribe from this list: send the line unsubscribe linux-kernel in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
hoi :) On Sat, Aug 20, 2005 at 07:37:06PM +0200, Sam Ravnborg wrote: In make_docs.log.tar.bz2, you can find log files from make htmldocs, make psdocs and make pdfdocs. From your log-files I could not see what went wrong. It seems to be error in the generated files. kerneldoc could not understand a macro definition. please try http://tali.admingilde.org/patches/linux-docbook/docbook-fixes.patch -- Martin Waitz signature.asc Description: Digital signature
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
On Sat, Aug 20, 2005 at 07:37:06PM +0200, Sam Ravnborg wrote: In make_docs.log.tar.bz2, you can find log files from make htmldocs, make psdocs and make pdfdocs. From your log-files I could not see what went wrong. It seems to be error in the generated files. kerneldoc could not understand a macro definition. please try http://tali.admingilde.org/patches/linux-docbook/docbook-fixes.patch Martin, your patch works for the htmldocs target, but not for the pdfdocs, I think there is a bug in a latex package. I don't know which one, but it's the same error. Thanks for your patch, Stephane -- Stephane Wirtel [EMAIL PROTECTED] [EMAIL PROTECTED] - To unsubscribe from this list: send the line unsubscribe linux-kernel in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
On Sat, Aug 20, 2005 at 11:19:41AM +0200, Stephane Wirtel wrote: > Le Saturday 20 August 2005 a 09:08, Sam Ravnborg ecrivait: > > > > > > Ok, with scripts/kernel-doc, I can produce some html files containing > > > the functions' documentation. > > > > > > make pdfdocs or others targets don't work :| > > > > You probarly need some additional packages. > > But it's not easy to help you with no log of what happened. > Yes, sorry, > > Kernel : 2.6.12 from the git repository of Linus. > > In make_docs.log.tar.bz2, you can find log files from make htmldocs, > make psdocs and make pdfdocs. >From your log-files I could not see what went wrong. It seems to be error in the generated files. Maybe Martin can help - Martin? Sam - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Le Saturday 20 August 2005 a 09:08, Sam Ravnborg ecrivait: > > > > Ok, with scripts/kernel-doc, I can produce some html files containing > > the functions' documentation. > > > > make pdfdocs or others targets don't work :| > > You probarly need some additional packages. > But it's not easy to help you with no log of what happened. Yes, sorry, Kernel : 2.6.12 from the git repository of Linus. In make_docs.log.tar.bz2, you can find log files from make htmldocs, make psdocs and make pdfdocs. Thanks, Stephane -- Stephane Wirtel <[EMAIL PROTECTED]> <[EMAIL PROTECTED]> make_docs.log.tar.bz2 Description: Binary data
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
> > Ok, with scripts/kernel-doc, I can produce some html files containing > the functions' documentation. > > make pdfdocs or others targets don't work :| You probarly need some additional packages. But it's not easy to help you with no log of what happened. Sam - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Ok, with scripts/kernel-doc, I can produce some html files containing the functions' documentation. make pdfdocs or others targets don't work :| You probarly need some additional packages. But it's not easy to help you with no log of what happened. Sam - To unsubscribe from this list: send the line unsubscribe linux-kernel in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Le Saturday 20 August 2005 a 09:08, Sam Ravnborg ecrivait: Ok, with scripts/kernel-doc, I can produce some html files containing the functions' documentation. make pdfdocs or others targets don't work :| You probarly need some additional packages. But it's not easy to help you with no log of what happened. Yes, sorry, Kernel : 2.6.12 from the git repository of Linus. In make_docs.log.tar.bz2, you can find log files from make htmldocs, make psdocs and make pdfdocs. Thanks, Stephane -- Stephane Wirtel [EMAIL PROTECTED] [EMAIL PROTECTED] make_docs.log.tar.bz2 Description: Binary data
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
On Sat, Aug 20, 2005 at 11:19:41AM +0200, Stephane Wirtel wrote: Le Saturday 20 August 2005 a 09:08, Sam Ravnborg ecrivait: Ok, with scripts/kernel-doc, I can produce some html files containing the functions' documentation. make pdfdocs or others targets don't work :| You probarly need some additional packages. But it's not easy to help you with no log of what happened. Yes, sorry, Kernel : 2.6.12 from the git repository of Linus. In make_docs.log.tar.bz2, you can find log files from make htmldocs, make psdocs and make pdfdocs. From your log-files I could not see what went wrong. It seems to be error in the generated files. Maybe Martin can help - Martin? Sam - To unsubscribe from this list: send the line unsubscribe linux-kernel in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Le Saturday 20 August 2005 a 00:08, Pekka Enberg ecrivait: > On 8/20/05, Stephane Wirtel <[EMAIL PROTECTED]> wrote: > > I don't know if there is a project based on Doxygen to make > > (or generate) a documentation of the kernel. > > > > Do you think that will be interesting to make a such document ? > > The kernel already has it's own API documentation generator called > kerneldoc. See the file Documentation/kernel-doc-nano-HOWTO.txt for > details. Ok, with scripts/kernel-doc, I can produce some html files containing the functions' documentation. make pdfdocs or others targets don't work :| Do you have ideas ? Thanks -- Stephane Wirtel <[EMAIL PROTECTED]> <[EMAIL PROTECTED]> - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
On 8/20/05, Stephane Wirtel <[EMAIL PROTECTED]> wrote: > I don't know if there is a project based on Doxygen to make > (or generate) a documentation of the kernel. > > Do you think that will be interesting to make a such document ? The kernel already has it's own API documentation generator called kerneldoc. See the file Documentation/kernel-doc-nano-HOWTO.txt for details. Pekka - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
On 8/20/05, Stephane Wirtel [EMAIL PROTECTED] wrote: I don't know if there is a project based on Doxygen to make (or generate) a documentation of the kernel. Do you think that will be interesting to make a such document ? The kernel already has it's own API documentation generator called kerneldoc. See the file Documentation/kernel-doc-nano-HOWTO.txt for details. Pekka - To unsubscribe from this list: send the line unsubscribe linux-kernel in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [Documentation] Use doxygen or another tool to generate a documentation ?
Le Saturday 20 August 2005 a 00:08, Pekka Enberg ecrivait: On 8/20/05, Stephane Wirtel [EMAIL PROTECTED] wrote: I don't know if there is a project based on Doxygen to make (or generate) a documentation of the kernel. Do you think that will be interesting to make a such document ? The kernel already has it's own API documentation generator called kerneldoc. See the file Documentation/kernel-doc-nano-HOWTO.txt for details. Ok, with scripts/kernel-doc, I can produce some html files containing the functions' documentation. make pdfdocs or others targets don't work :| Do you have ideas ? Thanks -- Stephane Wirtel [EMAIL PROTECTED] [EMAIL PROTECTED] - To unsubscribe from this list: send the line unsubscribe linux-kernel in the body of a message to [EMAIL PROTECTED] More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
