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 location ]  [-p people  |  --people  people  ]
       [-y  date   |  --date  date ]  [-d description  | --description description ]  [--longdesc
       longDescription]   [--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   documentation   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 values 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 modified 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)