Mercurial > bins

view doc/usage_desc_cli.xml @ 6:3021deef1599

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Encoding related fixes * chomp encoding string * reformat else (seems someone hacked it in) * debug print encoding * do not use :utf8 binmode ("re-encode") on written file if the input is _already_ UTF-8
author Peter Gervai <grin@grin.hu>
date Thu, 16 Oct 2008 00:02:14 +0200
parents a84c32f131df
children
line wrap: on
line source

<?xml version="1.0" encoding="LATIN1" ?>
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.2//EN" 
 "http://docbook.sourceforge.net/release/website/2.2/website.dtd" [
<!NOTATION XML SYSTEM "xml">
<!ENTITY usage_desc_cli    SYSTEM "usage_desc_cli.xml"    NDATA XML>
<!ENTITY usage_desc_gui    SYSTEM "usage_desc_gui.xml"    NDATA XML>
<!ENTITY usage_desc_xml    SYSTEM "usage_desc_xml.xml"    NDATA XML>
]>
<!-- $Id: usage_desc_cli.xml,v 1.3 2002/07/29 16:54:50 jerome Exp $ -->
<webpage id="usage_desc_cli">
  <config param="rcsdate" value="$Date: 2002/07/29 16:54:50 $"/>
  
  <head>
    <title>Command line interface</title>
    <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
  </head>

  <para>
    You can use the <command>bins_edit</command> program to set
    description fields or one or several images.  For example, to add
    the comment <userinput>my picture</userinput> to
    <filename>pic.jpg</filename>, go to the images directory (where
    <filename>pic.jpg</filename> is), and type:
  </para>

  <programlisting>
    bins_edit -d "my picture" pic.jpg
  </programlisting>

  <para>The <option>-d</option> option stands for description. You can
  set other fields, like location or date. Run <command>bins_edit
  --help</command> to see all fields available and read the
  <command><ulink url="bins_edit_man.html">bins_edit(1)</ulink></command>
  man page. The description text can be HTML with the
  <option>--html</option> switch. You can run
  <command>bins_edit</command> on several images, for example:</para>

  <programlisting>
    $ bins_edit -l "Paris" -y "2001" *.jpg
  </programlisting>

  <para>For each album (and sub-albums), you can also set a title, a
  description and a sample image to be used as a thumbnail to
  represent the album. To do so, you can use
  <command>bins_edit</command> with the<option> --album</option>
  switch. Type <command>bins_edit --help</command> for more
  details.</para>

  <para>
    After setting or changing any fields, you have to rerun
    <command>bins</command> to generate new HTML pages.
  </para>

</webpage>