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)