Difference between revisions of "Slack-desc"

From SlackWiki
Jump to navigation Jump to search
(Undo revision 249 by Sahko (Talk))
Line 29: Line 29:
The "handy ruler" is meant to stop you at 79 characters, because the standard
The "handy ruler" is meant to stop you at 79 characters, because the standard
console is 80x25 and if you go beyond this the words will wrap.
console is 80x25 and if you go beyond this the words will wrap.
The space after the : is needed only when there is text after the :


=See Also=
=See Also=

Revision as of 06:59, 7 September 2009

Overview

A proper slack-desc file should be written as follows:

# HOW TO EDIT THIS FILE:
# The "handy ruler" below makes it easier to edit a package description.  Line
# up the first '|' above the ':' following the base package name, and the '|' on
# the right side marks the last column you can put a character in.  You must make
# exactly 11 lines for the formatting to be correct.  It's also customary to
# leave one space after the ':'.

       |-----handy-ruler------------------------------------------------------|
appname: Summary of application name and function (one line only)
appname:      <this line is generally left blank>
appname: Description of application  -  this description should be fairly
appname: in-depth; in other words, make it clear what the package does (and 
appname: maybe include relevant links and/or instructions if there's room),
appname: but don't get too verbose.  
appname: This file can have a maximum of eleven (11) lines of text preceded by
appname: the "appname: " designation.  
appname: 
appname: It's a good idea to include a link to the application's homepage too.
appname: 

The "appname" string must *exactly* match the application name portion of the Slackware package (for example, a package titled "gaim-1.5-i486-1.tgz" must have a slack-desc file with the <appname> string of "gaim: " rather than "Gaim: " or "GAIM: " or something else.

The "handy ruler" is meant to stop you at 79 characters, because the standard console is 80x25 and if you go beyond this the words will wrap.

The space after the : is needed only when there is text after the :

See Also

man makepkg
man pkgtool