bins_edit — Set fields in XML picture description files for BINS
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 ...]
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
bins_edit sets values in the XML picture description files that bins(1)
uses to generate galleries.
This program follows the usual GNU command line syntax, with long
options starting with two dashes (‘-’). A summary of options is
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.
--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.
--html input value will be interpreted as HTML code, thus, no HTML
encoding or quoting will be done.
Set the title (of an image.)
Set the event name (of an album or image.)
Set the location (of an image.)
Set the list of people (of an image.)
Set the date (of an image.)
Set the description (of an image.)
Set the long description (of an album.)
Set the short description (of an album.)
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.
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.
--help Gives quick help (which this man page is based on.)
--verbose This switch can appear several times to increase verbosity
--quiet Suppress output.
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
This manual page was written by Mark W. Eichin email@example.com 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