Man Linux: Main Page and Category List

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 coolfile.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)