Mercurial > bins

view doc/bins-edit-gui_man.html @ 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

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>BINS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><H1
><A
NAME="AEN1"
></A
>BINS</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN15"
></A
><H2
>Name</H2
>bins-edit-gui&nbsp;--&nbsp;Set fields in XML picture description files for BINS
      (using a GNOME-based GUI)</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18"
></A
><H2
>Synopsis</H2
><P
><B
CLASS="COMMAND"
>bins-edit-gui</B
>  [<TT
CLASS="REPLACEABLE"
><I
>files</I
></TT
>...]</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23"
></A
><H2
>DESCRIPTION</H2
><P
>This manual page documents briefly the
      <B
CLASS="COMMAND"
>bins-edit-gui</B
> command.</P
><P
><B
CLASS="COMMAND"
>bins-edit-gui</B
> sets values in the XML
      picture description files that <B
CLASS="COMMAND"
>bins</B
>(1) uses
      to generate galleries.  It displays the image (scaled down to
      fit the window) and allows you to fill in the predefined fields
      (or add new ones.)  For command-line editing of the same data,
      see <B
CLASS="COMMAND"
>bins_edit</B
>(1).
    </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN31"
></A
><H2
>OPTIONS</H2
><P
>This program follows the usual GNU command line syntax,
      with long options starting with two dashes (`-').  A summary of
      options is included below.</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="REPLACEABLE"
><I
>file</I
></TT
></DT
><DD
><P
><TT
CLASS="REPLACEABLE"
><I
>file</I
></TT
> is the
	    filename of the image itself.</P
></DD
><DT
><CODE
CLASS="OPTION"
>-v</CODE
>, <CODE
CLASS="OPTION"
>--version</CODE
></DT
><DD
><P
>Displays program version.</P
></DD
><DT
><CODE
CLASS="OPTION"
>-v</CODE
>, <CODE
CLASS="OPTION"
>--version</CODE
></DT
><DD
><P
>Displays program version.</P
></DD
><DT
><CODE
CLASS="OPTION"
>-h</CODE
>, <CODE
CLASS="OPTION"
>--help</CODE
></DT
><DD
><P
>Displays command-line options.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--debug</CODE
></DT
><DD
><P
>Enables random developer debugging messages.</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN67"
></A
><H2
>COMMANDS</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><SPAN
CLASS="KEYCODE"
>C-n</SPAN
> <B
CLASS="COMMAND"
>Next file</B
></DT
><DD
><P
>Save current tags set (if any changes have been made)
	    and move on to the next image.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>M-Page Down</SPAN
> <B
CLASS="COMMAND"
>Forward 10</B
></DT
><DD
><P
>Save current tags set (if any changes have been made)
	    and skip forward by 10 files.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>C-p</SPAN
> <B
CLASS="COMMAND"
>Previous file</B
></DT
><DD
><P
>Save current tags set (if any changes have been made)
	    and move back to the previous image.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>M-Page Up</SPAN
> <B
CLASS="COMMAND"
>Back 10</B
></DT
><DD
><P
>Save current tags set (if any changes have been made)
	    and skip backwards by 10 files.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>M-Home</SPAN
> <B
CLASS="COMMAND"
>Start of List</B
></DT
><DD
><P
>Save current tags set (if any changes have been made)
	    and jump to the first file.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>M-End</SPAN
> <B
CLASS="COMMAND"
>End of List</B
></DT
><DD
><P
>Save current tags set (if any changes have been made)
	    and jump to the last file.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>M-a</SPAN
> <B
CLASS="COMMAND"
>Auto-fill</B
></DT
><DD
><P
>Fill in any blank fields with the values from the most
	    recently seen image.  Particularly useful for copying a
	    location or event across a set of images.</P
></DD
><DT
><B
CLASS="COMMAND"
>Revert</B
></DT
><DD
><P
>Reload tags from the <ACRONYM
CLASS="ACRONYM"
>XML</ACRONYM
> file,
	    wiping unsaved changes.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>C-s</SPAN
> <B
CLASS="COMMAND"
>Save</B
></DT
><DD
><P
>Save changes, if any.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>F2</SPAN
> <B
CLASS="COMMAND"
>Album</B
></DT
><DD
><P
>Edit the album this picture is in.  (Under
	    construction, but functional.)</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>F3</SPAN
> <B
CLASS="COMMAND"
>Open</B
></DT
><DD
><P
>Not yet implemented.  Should provide a file browser later.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>&#62;</SPAN
> <B
CLASS="COMMAND"
>Rotate Right</B
></DT
><DD
><P
>Rotate image to the Right (Clockwise.)  Actually sets
	    the <CODE
CLASS="SGMLTAG"
>Orientation</CODE
> tag with
	    <CODE
CLASS="SGMLTAG"
>priority</CODE
> 1 so that it overrides the
	    corresponding <ACRONYM
CLASS="ACRONYM"
>EXIF</ACRONYM
> tag; it does not
	    modify the image file itself.</P
></DD
><DT
><B
CLASS="COMMAND"
>Cancel rotation</B
></DT
><DD
><P
>Cancels any current changes to the rotation tags
	    (effectively, this is a "revert" function for the
	    rotation, it doesn't to back to the original
	    <ACRONYM
CLASS="ACRONYM"
>EXIF</ACRONYM
> tags in the
	    <ACRONYM
CLASS="ACRONYM"
>JPEG</ACRONYM
> file.)</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>&#60;</SPAN
> <B
CLASS="COMMAND"
>Rotate Left</B
></DT
><DD
><P
>Rotate image to the Left (Counter Clockwise.)  Actually sets
	    the <CODE
CLASS="SGMLTAG"
>Orientation</CODE
> tag with
	    <CODE
CLASS="SGMLTAG"
>priority</CODE
> 1 so that it overrides the
	    corresponding <ACRONYM
CLASS="ACRONYM"
>EXIF</ACRONYM
> tag; it does not
	    modify the image file itself.</P
></DD
><DT
><SPAN
CLASS="KEYCODE"
>C-q</SPAN
> <B
CLASS="COMMAND"
>Quit</B
></DT
><DD
><P
>Quit program, saving current changes (if any.)</P
></DD
><DT
><B
CLASS="COMMAND"
>About</B
></DT
><DD
><P
>Display About box.</P
></DD
><DT
><B
CLASS="COMMAND"
>License</B
></DT
><DD
><P
>Display License box.</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN177"
></A
><H2
>EXAMPLES</H2
><P
>Edit all the images in a directory:
      <P
><B
CLASS="COMMAND"
>bins-edit-gui $(find bins-picture-dir -name '*.jpg')</B
> </P
>
    </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN182"
></A
><H2
>SEE ALSO</H2
><P
>bins (1), bins_edit (1).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN185"
></A
><H2
>AUTHOR</H2
><P
>This manual page was written by Mark W. Eichin <CODE
CLASS="EMAIL"
>&#60;<A
HREF="mailto:eichin@thok.org"
>eichin@thok.org</A
>&#62;</CODE
>.</P
></DIV
></BODY
></HTML
>