BINS(1) 						      General Commands Manual							   BINS(1)

NAME

       bins_edit -- Set fields in XML picture description files for BINS

SYNOPSIS

       bins_edit  [-a	| --album ]  [-m  | --html ]  [-t title  | --title title ]  [-e event  | --event event ]  [-l location	| --location loca-
       tion ]  [-p people  | --people people ]	[-y date  | --date date ]  [-d description  | --description  description  ]   [--longdesc  longDe-
       scription]   [--shortdesc  shortDescription]   [--sample pictureFileName]  [-g  tag=value  | --generic tag=value ]  [-h	| --help ]  [-v  |
       --verbose ]  [-q  | --quiet ]  [file]  [files ...]

DESCRIPTION

       This manual page documents briefly the bins_edit command.

       This manual page was written for the Debian distribution because the original program does not have a manual page.  Instead, it	has  docu-
       mentation in HTML in /usr/share/doc/bins/index.html as well as a --help option.

       bins_edit sets values in the XML picture description files that bins(1) uses to generate galleries.

OPTIONS

       This program follows the usual GNU command line syntax, with long options starting with two dashes (`-').  A summary of options is included
       below.

       file	 By default, file is the filename of the XML file with the image properties.  If the argument has no .xml suffix, it is added,	so
		 you can directly give picture names on the command line.  Spaces and other special characters (even newlines) can be used in val-
		 ues given as parameters as long as they are enclosed between quotes.

		 If the --album option is given, the filename refers to the directory of images, and the album.xml in that directory will be modi-
		 fied instead.

       -a

       --album	 edit  album  description (instead of the default of editing the image description.)  In this case, the file parameter must be the
		 source directory of the album.  Only the --title, --longdesc, --shortdesc and	--sample		     switches  make  sense
		 with this option.

       -m

       --html	 input value will be interpreted as HTML code, thus, no HTML encoding or quoting will be done.

       -t title

       --title title
		 Set the title (of an image.)

       -e event

       --event event
		 Set the event name (of an album or image.)

       -l location

       --location location
		 Set the location (of an image.)

       -p people

       --people people
		 Set the list of people (of an image.)

       -y date

       --date date
		 Set the date (of an image.)

       -d description

       --description description
		 Set the description (of an image.)

       --longdesc longDescription
		 Set the long description (of an album.)

       --shortdesc shortDescription
		 Set the short description (of an album.)

       --sample pictureFileName
		 Select  the  sample  picture, within this album, to be used on the album list (template subalbum.html.) Note that the filename is
		 relative to the album directory, and thus doesn't have a directory component.

       -g  tag=value

       --generic tag=value
		 This lets you set arbitrary fields in the relevant XML file (of the image or the album.)  Generic tags appear inside  description
		       which  appears inside image; the tag appears as the name attribute of a field element, and the value appears as the content
		 of the element.

       -h

       --help	 Gives quick help (which this man page is based on.)

       -v

       --verbose This switch can appear several times to increase verbosity level.

       -q

       --quiet	 Suppress output.

EXAMPLES

       Set the title of the Image.jpg file to "My picture":

       bins_edit -t "My picture" Image.jpg

       Set the title and location of all JPEG pictures in the directory:

       bins_edit --title Holiday --location Paris *.jpg

       Use of HTML values:

       bins_edit --html --description '<b>BINS</b> is cool' file.jpg

       Set the title short description and sample image of the album in the current directory (note the dot as final parameter):

       bins_edit -a -t "My Album" --sample image.jpg --shortdesc "This is my album" .

SEE ALSO

       bins (1).

AUTHOR

       This manual page was written by Mark W. Eichin eichin@thok.org for the Debian system (but may be used by others).  As it is mostly  derived
       from the bins_edit program itself, it is covered by the GNU General Public License.

																	   BINS(1)