Mercurial > bins

diff doc/usage_desc_cli.xml @ 0:a84c32f131df 1.1.29

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import vendor version
author Peter Gervai <grin@grin.hu>
date Wed, 15 Oct 2008 23:28:56 +0200
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/usage_desc_cli.xml	Wed Oct 15 23:28:56 2008 +0200
@@ -0,0 +1,54 @@
+<?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>