Re: Preferred way of putting title in section

From: David Nečas <yeti physics muni cz>
To: Krzesimir Nowak <qdlacz gmail com>
Cc: gtk-doc-list gnome org
Subject: Re: Preferred way of putting title in section
Date: Wed, 2 Sep 2009 09:17:16 +0200

On Wed, Sep 02, 2009 at 12:46:56AM +0200, Krzesimir Nowak wrote:
> which way of putting title of section is preferred?
> 1. ` title: my title' in SECTION comment in source code.
> 2. `<TITLE>my title</TITLE> in package-sections.txt.
> 
> There is a FIXME in `Documenting section' in gtk-doc manual about this.
> It would be good to have it clarified.

The former because package-sections.txt can be (and should be) generated
nowadays with gtkdoc-scan --rebuild-sections if you have sanely
organized header files.

Yeti

References:
- Preferred way of putting title in section
  - From: Krzesimir Nowak

[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]