Re: [LCFC] templates://fltk1.1/{libfltk1.1-dev.templates}
Aaron M. Ucko wrote:
> In general, I'm pretty happy with this draft; thanks for the
> suggestions! My one concern is that the descriptions alternate
> between starting with the package name and "this package"; while I'm
> willing to go either way (acknowledging the futility of avoiding the
> latter), I'd prefer to do so consistently.
Attached with "This package provides..." throughout (the rationale
being that it avoids the need for capitalised package names).
--
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../fltk1.1.old/debian/libfltk1.1-dev.templates 2007-11-08 08:31:48.000000000 +0000
+++ debian/libfltk1.1-dev.templates 2007-11-10 09:51:06.000000000 +0000
@@ -3,6 +3,8 @@
Default: false
_Description: Make .h links to <FL/*.H>?
For compatibility with some older code, FLTK used to make its C++-specific
- headers available as <FL/*.h> as well as <FL/*.H>; however, the
- lowercase-h names are deprecated, and we recommend eliminating them from
- your code regardless.
+ headers available as <FL/*.h> as well as <FL/*.H>. However, the
+ lowercase-h names are deprecated and should be eliminated from
+ source code.
+ .
+ Please choose whether such compatibility symlinks should be created.
--- ../fltk1.1.old/debian/control 2007-11-08 08:31:48.000000000 +0000
+++ debian/control 2007-11-21 11:40:32.000000000 +0000
@@ -15,13 +15,15 @@
Suggests: fltk1.1-doc
Conflicts: libfltk1-dev
Replaces: libfltk1-dev
-Description: Fast Light (Toolkit) User Interface Designer
- Fluid is an interactive GUI designer for the Fast Light Toolkit,
- allowing graphical development of FLTK-based user interfaces. It
- natively works with (textual) .fl files, but also includes rough
- support for reading .fd files produced by fdesign (in libforms-bin).
- (FLTK is a very nice LGPLed cross-platform graphical user interface
- toolkit originally based on libForms.)
+Description: Fast Light Toolkit - user interface designer
+ This package provides Fluid, an interactive GUI designer for FLTK,
+ allowing graphical development of FLTK-based user
+ interfaces. It natively works with (textual) .fl files, but also
+ includes rough support for reading .fd files produced by fdesign (in
+ libforms-bin).
+ .
+ The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
+ toolkit originally based on libForms.
Package: libfltk1.1-dev
Section: libdevel
@@ -32,10 +34,12 @@
Provides: libfltk-dev
Conflicts: libfltk-dev
Replaces: libfltk-dev
-Description: Fast Light Toolkit development files
- Libfltk1.1-dev contains the files necessary for compiling programs
- that depend on FLTK, a very nice LGPLed cross-platform C++ GUI
- (graphical user interface) toolkit originally based on libForms.
+Description: Fast Light Toolkit - development files
+ This package provides the files necessary for compiling programs
+ that depend on FLTK.
+ .
+ The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
+ toolkit originally based on libForms.
Package: libfltk1.1
Section: libs
@@ -43,10 +47,12 @@
Depends: ${shlibs:Depends}
Conflicts: libfltk1.1c102
Replaces: libfltk1.1c102
-Description: Fast Light Toolkit shared libraries
- Libfltk1.1 contains the files necessary for running programs
- dynamically linked with FLTK, a very nice LGPLed cross-platform
- graphical user interface toolkit originally based on libForms.
+Description: Fast Light Toolkit - shared libraries
+ This package provides the files necessary for running programs
+ dynamically linked with FLTK.
+ .
+ The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
+ toolkit originally based on libForms.
Package: libfltk1.1-dbg
Section: libdevel
@@ -56,31 +62,36 @@
Recommends: gdb (>= 6.0)
Conflicts: libfltk1.1c102-dbg
Replaces: libfltk1.1c102-dbg
-Description: Fast Light Toolkit shared libraries (debugging symbols)
+Description: Fast Light Toolkit - shared libraries with debugging symbols
This package is useful to provide a backtrace with symbol names in a
debugger; this facilitates interpretation of core dumps, and aids in finding
- logic errors in programs using the libraries in this package (or the
+ logic errors in programs using the libraries (or in the
libraries themselves).
.
- Non-programmers will likely have little use for this package. See the
- libfltk1.1 package for more information.
+ Non-programmers will likely have little use for this.
+ .
+ The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
+ toolkit originally based on libForms.
Package: fltk1.1-doc
Section: doc
Architecture: all
-Description: Fast Light Toolkit documentation
- Fltk1.1-doc contains documentation for FLTK, a very nice LGPLed
- cross-platform graphical user interface toolkit originally based on
- libForms, including a chapter on its user interface designer (fluid).
+Description: Fast Light Toolkit - documentation
+ This package provides documentation for FLTK, including a chapter on
+ its user interface designer (fluid).
+ .
+ The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
+ toolkit originally based on libForms.
Package: fltk1.1-games
Section: games
Architecture: any
Depends: ${shlibs:Depends}
-Description: Fast Light Toolkit example games: checkers, sudoku
- Fltk1.1-games contains the example games that accompany FLTK, a very
- nice LGPLed cross-platform graphical user interface toolkit
- originally based on libForms. Specifically, it contains the
- following two programs:
- * flcheckers - classic board game, also known as draughts
- * flsudoku - Sudoku puzzle (place numbers in a grid)
+Description: Fast Light Toolkit - example games: checkers, sudoku
+ This package provides the example games that accompany FLTK.
+ Specifically, it contains the following two programs:
+ - flcheckers: classic board game, also known as draughts;
+ - flsudoku: Sudoku puzzle (place numbers in a grid).
+ .
+ The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
+ toolkit originally based on libForms.
Template: libfltk1.1-dev/header-links
Type: boolean
Default: false
_Description: Make .h links to <FL/*.H>?
For compatibility with some older code, FLTK used to make its C++-specific
headers available as <FL/*.h> as well as <FL/*.H>. However, the
lowercase-h names are deprecated and should be eliminated from
source code.
.
Please choose whether such compatibility symlinks should be created.
Source: fltk1.1
Section: libs
Priority: optional
Maintainer: Aaron M. Ucko <ucko@debian.org>
Build-Depends: cdbs (>= 0.4.39-0.1), debhelper (>= 5), libjpeg62-dev, libpng12-dev, libxft-dev (>> 2.1.2), libxext-dev, libxinerama-dev, libx11-dev, zlib1g-dev | libz-dev, libgl1-mesa-dev | libgl-dev, libglu1-mesa-dev | libglu-dev, libasound2-dev [!hurd-i386 !kfreebsd-i386 !kfreebsd-amd64], imagemagick
Build-Depends-Indep: htmldoc
Standards-Version: 3.7.2
Homepage: http://www.fltk.org/
Package: fluid
Section: devel
Architecture: any
Depends: ${shlibs:Depends}
Recommends: libfltk1.1-dev
Suggests: fltk1.1-doc
Conflicts: libfltk1-dev
Replaces: libfltk1-dev
Description: Fast Light Toolkit - user interface designer
This package provides Fluid, an interactive GUI designer for FLTK,
allowing graphical development of FLTK-based user
interfaces. It natively works with (textual) .fl files, but also
includes rough support for reading .fd files produced by fdesign (in
libforms-bin).
.
The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
toolkit originally based on libForms.
Package: libfltk1.1-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libfltk1.1 (= ${binary:Version}), libx11-dev
Recommends: libgl1-mesa-dev | libgl-dev
Suggests: fltk1.1-doc, fluid, libglu1-mesa-dev | libglu-dev, libjpeg62-dev, libpng12-0-dev, libxft-dev (>> 2.1.2), libxext-dev, libxinerama-dev, zlib1g-dev | libz-dev
Provides: libfltk-dev
Conflicts: libfltk-dev
Replaces: libfltk-dev
Description: Fast Light Toolkit - development files
This package provides the files necessary for compiling programs
that depend on FLTK.
.
The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
toolkit originally based on libForms.
Package: libfltk1.1
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Conflicts: libfltk1.1c102
Replaces: libfltk1.1c102
Description: Fast Light Toolkit - shared libraries
This package provides the files necessary for running programs
dynamically linked with FLTK.
.
The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
toolkit originally based on libForms.
Package: libfltk1.1-dbg
Section: libdevel
Priority: extra
Architecture: any
Depends: libfltk1.1 (= ${binary:Version})
Recommends: gdb (>= 6.0)
Conflicts: libfltk1.1c102-dbg
Replaces: libfltk1.1c102-dbg
Description: Fast Light Toolkit - shared libraries with debugging symbols
This package is useful to provide a backtrace with symbol names in a
debugger; this facilitates interpretation of core dumps, and aids in finding
logic errors in programs using the libraries (or in the
libraries themselves).
.
Non-programmers will likely have little use for this.
.
The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
toolkit originally based on libForms.
Package: fltk1.1-doc
Section: doc
Architecture: all
Description: Fast Light Toolkit - documentation
This package provides documentation for FLTK, including a chapter on
its user interface designer (fluid).
.
The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
toolkit originally based on libForms.
Package: fltk1.1-games
Section: games
Architecture: any
Depends: ${shlibs:Depends}
Description: Fast Light Toolkit - example games: checkers, sudoku
This package provides the example games that accompany FLTK.
Specifically, it contains the following two programs:
- flcheckers: classic board game, also known as draughts;
- flsudoku: Sudoku puzzle (place numbers in a grid).
.
The Fast Light Toolkit (FLTK) is a cross-platform graphical user interface
toolkit originally based on libForms.
Reply to: