Permalink
Browse files

Bump version to 1.0pre1; re-order the HTML page;

remove the changelog section from the HTML page so we
only have one ChangeLog to update.
  • Loading branch information...
1 parent 87cef5d commit c4a8f2614443fe6c9006380914a5f8ca4016a065 @akkana committed Jul 9, 2016
Showing with 103 additions and 199 deletions.
  1. +16 −0 ChangeLog
  2. +1 −1 Makefile
  3. +86 −198 doc/pho.html
View
@@ -1,3 +1,19 @@
+7/9/2016, pho 1.0pre1
+ Add middlemouse dragging in presentation mode.
+
+9/5/2012, pho-0.9.8
+ Finally! An actual release!
+
+4/10/2012, Pho 0.9.7-pre8
+ Add captions/image comments (from David <somloieater@gmail.com>) with -c.
+ Improve scaling up from keywords mode (but some scaling issues remain).
+ More aspect ratio fixing and code cleanup.
+
+4/17/2011, Pho 0.9.7-pre7
+ Fix aspect ratio of fullsize mode on vertical images;
+ increase keyword dialog height, and add some keyword dialog
+ reliability fixes; fix build warnings reported on Irix.
+
11/26/2010, Pho 0.9.7-pre6:
Much more reliable scaling code -- this (I hope) fixes the
problems with aspect ratio upon rotation.
View
@@ -1,6 +1,6 @@
# Makefile for pho
-VERSION = 0.9.8
+VERSION = 1.0pre1
# Locate the gtk/gdk libraries (thanks to nev for this!)
GTKFLAGS := $(shell pkg-config --cflags gtk+-2.0 gdk-2.0 2> /dev/null)
View
@@ -25,25 +25,6 @@
To get it, <a href="#download">skip to the download section.</a>
<p>
-The big change here is Keywords mode. It uses the same note flags
-that Pho has always had, but Keywords mode gives you an easy way to
-annotate a directory of images with strings. You can type in phrases
-for each note, and you can have up to 31 notes now, not just 10.
-If you use Pho to categorize your photos, you'll find Keywords mode
-very handy.
-
-<p>
-In Keywords mode you can also type in a unique image comment for each
-image. Comments aren't tied to the numbered image flags -- each image
-has its own comment.
-
-<p>
-There's also a slideshow mode, where you specify the interval in seconds
-(e.g. pho -p -s5 for a 5-second delay between images).
-You can use this for a screensaver, or just to go through slides
-automatically. Hitting the spacebar cancels slideshow mode.
-
-<p>
You can now customize the command called up with the 'g' key.
It defaults to gimp (not gimp-remote as in previous pho versions),
but you can call any program you like,
@@ -76,50 +57,6 @@
<p>
<a href="#download">Skip to the download section</a>.
-<h2>Why another image viewer? Surely there are plenty of those?</h2>
-
-<p>
-I used to use xv for paging through images -- it's quite a good
-viewing program -- but it had a few features which annoyed me. For
-example, it creates a directory called .xvpics in every directory it touches;
-and if an image has to be resized to fit the screen, and after that
-you save it (perhaps after rotating it), it saves at the smaller size
-and boom, there goes your high-res image.
-
-<p>
-But, more important, there were a few extra things I needed.
-During image triage, I need to be able to do a few things quickly:
-<ul>
-<li>Rotate images by multiples of 90 degrees, and remember the rotations.
-<li>Delete bad images.
-<li>Copy a few of the best horizontals to my Backgrounds (wallpaper) directory.
-<li>Note which images I might want to put on a web page (after resizing).
-</ul>
-With xv, I found that I was writing these lists on paper, or trying
-to keep track of them in my head. That's dumb! Why not make the
-computer do that work? So I did.
-
-<p>
-Since I wrote pho several years ago, I keep hearing about other
-image viewers, and thinking maybe pho was redundant. But I recently
-did a search, and couldn't come up with any other image viewers that
-are similarly efficient for paging through large collections of
-images. So I guess I'll keep maintaining pho!
-
-<p>
-Pho can read any format supported by gdk-pixbuf. I haven't found a
-list of those formats anywhere, but it seems to be substantial.
-The only format I've hit so far that it doesn't read is photocd.
-You can convert those to other formats using the ImageMagick utility.
-
-<p>
-Pho can delete images on disk, but it can't save rotated
-images yet.
-I use my <a href="../imagebatch/">imagebatch</a> scripts for that,
-or you can use a commandline utility like <a
-href="http://imagemagick.org">ImageMagick</a>
-(which is what my imagebatch scripts use under the hood).
-
<h2>How to use pho</h2>
Usage: pho *.jpg (or whatever).<br>
@@ -154,15 +91,7 @@
</dl>
<p>
-Presentation mode makes pho fullscreen; it also enables mouse bindings,
-where dragging with the middle mouse button will pan in the image.
-By default, pho will scale images to fit the screen, but if you
-zoom in, either with f (full size) or + (double size), panning
-is useful. (In non-presentation mode, you can use your window manager
-to move the window.)
-
-<p>
-pho will remember the correct (last shown) rotation for each image.
+Pho will remember the correct (last shown) rotation for each image.
When it exits (either because the last image was viewed or because
the user typed q), it will print out the images that need to be
rotated and deleted (it does not actually change the files on disk),
@@ -171,6 +100,91 @@
a web page, 2 on the couple of photos that need additional editing
in gimp, and 3 on the photos I want to save as desktop backgrounds.
+<h3>Modes</h3>
+
+<h4>Presentation mode</h4>
+
+<p>
+Normally, Pho shows images in its own window, and it tries hard to
+move and resize the window as needed to keep the window the right size
+and over the mouse.
+<p>
+Presentation mode (-p) makes pho fullscreen.
+It also enables dragging with the middle mouse button to pan in the image.
+By default, pho will scale images to fit the screen, so there's no
+need to pan; but if you zoom in, either with f (full size) or +
+(double size), you may want a way to move around in the image.
+ (In non-presentation mode, the image is in its own window, so you
+can move the window using your window manager.)
+Pho's author uses presentation mode as her default: <code>PHO_ARGS=-p</code>
+and runs <code>pho -P</code> in the rare cases where she doesn't want
+fullscreen.
+
+<h4>Slideshow mode</h4>
+<p>
+There's also a new slideshow mode, where you specify the interval in seconds
+(e.g. pho -p -s5 for a 5-second delay between images).
+You can use this for a screensaver, or just to go through slides
+automatically. Hitting the spacebar cancels slideshow mode.
+
+<h4>Keywords mode</h4>
+<p>
+Keywords mode gives you an easy way to annotate a directory of images
+with strings. You can type in phrases for each note, and you can have
+up to 31 notes now.
+You can also type in a unique image comment for each
+image. Comments aren't tied to the numbered image flags -- each image
+has its own comment.
+<p>
+Keywords and comments are available in every pho mode (via the info dialog:
+type i in any image to see current keywords and comment). Keywords mode
+just gives better access to this.
+However, you may find <a href="https://github.com/akkana/metapho">metapho</a>
+to be a better way to mange keywords.
+
+<h2>Why another image viewer? Surely there are plenty of those?</h2>
+
+<p>
+I used to use xv for paging through images -- it's quite a good
+viewing program -- but it had a few features which annoyed me. For
+example, it creates a directory called .xvpics in every directory it touches;
+and if an image has to be resized to fit the screen, and after that
+you save it (perhaps after rotating it), it saves at the smaller size
+and boom, there goes your high-res image.
+
+<p>
+But, more important, there were a few extra things I needed.
+During image triage, I need to be able to do a few things quickly:
+<ul>
+<li>Rotate images by multiples of 90 degrees, and remember the rotations.
+<li>Delete bad images.
+<li>Copy a few of the best horizontals to my Backgrounds (wallpaper) directory.
+<li>Note which images I might want to put on a web page (after resizing).
+</ul>
+With xv, I found that I was writing these lists on paper, or trying
+to keep track of them in my head. That's dumb! Why not make the
+computer do that work? So I did.
+
+<p>
+Since I wrote pho several years ago, I keep hearing about other
+image viewers, and thinking maybe pho was redundant. But I recently
+did a search, and couldn't come up with any other image viewers that
+are similarly efficient for paging through large collections of
+images. So I guess I'll keep maintaining pho!
+
+<p>
+Pho can read any format supported by gdk-pixbuf. I haven't found a
+list of those formats anywhere, but it seems to be substantial.
+The only format I've hit so far that it doesn't read is photocd.
+You can convert those to other formats using the ImageMagick utility.
+
+<p>
+Pho can delete images on disk, but it doesn't save rotated images.
+I use my <a href="../imagebatch/">imagebatch</a> scripts for that,
+or you can use a commandline utility like <a
+href="http://imagemagick.org">ImageMagick</a>
+(which is what my imagebatch scripts use under the hood).
+
<a name="download">
<h2>Download: Getting pho</h2>
<p>
@@ -234,132 +248,6 @@
If you like pho, or if you think it's promising but there's some
feature it really needs ... <a href="../../mailme.html">let me know!</a>
-<h2>Changelog</h2>
-<dl>
-<td>9/5/2012, <a href="pho-0.9.8.tar.gz">pho-0.9.8</a>:
-<dd>Finally! An actual release!
-<dt>4/10/2012, <a href="pho-0.9.7-pre8.tar.gz">Pho 0.9.7-pre8</a>:
-<dd>Add captions/image comments (from David <somloieater@gmail.com>) with -c.
- Improve scaling up from keywords mode (but some scaling issues remain).
- More aspect ratio fixing and code cleanup.
-<dt>4/17/2011, <a href="pho-0.9.7-pre7.tar.gz">Pho 0.9.7-pre7</a>:
-<dd>Fix aspect ratio of fullsize mode on vertical images;
- increase keyword dialog height, and add some keyword dialog
- reliability fixes; fix build warnings reported on Irix.
-<dt>11/26/2010, <a href="pho-0.9.7-pre6.tar.gz">Pho 0.9.7-pre6</a>:
-<dd>Much more reliable scaling code -- this (I hope) fixes the
- problems with aspect ratio upon rotation.
- New PHO_SCALE_FIXED mode: keep image's larger dimension <= the given size.
- Use PHO_SCALE_FIXED and .75 times the shorter dimension of the screen
- for Keywords mode.
- Alt+num toggles 10+num flag.
-<dt>4/10/2010, <a href="pho-0.9.7-pre5.tar.gz">Pho 0.9.7-pre5</a>:
-<dd>Fix a slew of subtle bugs involving going back and forward in the image
-list (e.g. when specifying nonexistent images). Add some information
-on how to test for regressions.
-<dt>2/9/2009, <a href="pho-0.9.7-pre4.tar.gz">Pho 0.9.7-pre4</a>:
-<dd>Fix a race condition involving the keywords dialog getting focus.
-<dt>12/15/2009, <a href="pho-0.9.7-pre3.tar.gz">Pho 0.9.7-pre3</a>:
-<dd>More cleanup of rotation/scaling, and transitions from one mode
- to the next.
-<dt>9/26/2009, <a href="pho-0.9.7-pre2.tar.gz">Pho 0.9.7-pre2</a>:
-<dd>
- Add ability to add new image files or change the list without restarting.
- Total cleanup/rewrite of rotate/scale logic.
- Remove old gtk1 code.
-<dt>??/??/2009, <a href="pho-0.9.7-pre1.tar.gz">Pho 0.9.7-pre1</a>:
-<dd>Clean up rotation code;
- List images with incorrect exif rotation;
- smarter PHO_REMOTE (can do other things, not just GIMP);
- don't go fullscreen from Ctrl-F in the keywords dialog.
- fix a minor Mac build issue.
-<dt>11/9/2008, <a href="pho-0.9.6.tar.gz">Pho 0.9.6</a>:
-<dd>RELEASE! The only difference from 0.9.6-pre3 is to change
- the default PHO_REMOTE command from gimp-remote to gimp,
- since gimp-remote is obsolete and no longer provided in Linux
- distros (and never was, on Mac or Win).
-<dt>10/2/2008, <a href="pho-0.9.6-pre3.tar.gz">Pho 0.9.6-pre3</a>:
-<dd>Change the list next/prev code to fix (I hope) a bug where pho
- would get confused and cycle from the last image back to the first.
-<dt>8/13/2008, <a href="pho-0.9.6-pre2.tar.gz">Pho 0.9.6-pre2</a>:
-<dd>Simplify exif/Makefile so it'll work on FreeBSD and other
- systems where make is non-GNU make.
-<dt>8/11/2008, <a href="pho-0.9.6-pre1.tar.gz">Pho 0.9.6-pre1</a>:
-<dd>Add Keyword mode. Add slideshow mode. Swap -f and -F.
- Add PHO_REMOTE environment variable.
- Lots of performance and stability work.
-<dt>8/6/2007, <a href="pho-0.9.5.1.tar.gz">Pho 0.9.5.1</a>:
-<dd>Fix a buffer overflow bug on the 'g' key,
- which runs gimp-remote on the current file.
-<dt>3/20/2007, <a href="pho-0.9.5.tar.gz">Pho 0.9.5</a>:
-<dd>No changes except some manual and html page updates.
-<dt>3/5/2007, <a href="pho-0.9.5-pre5.tar.gz">Pho 0.9.5-pre5</a>:
-<dd>Check for a PHO_ARGS environment variable.
- Add a -P argument to force non-presentation mode.
- Fix a few bugs with double/half size and with scaling.<br>
- Make note 0 work properly.
-<dt>7/24/2005, <a href="pho-0.9.5-pre4.tar.gz">Pho 0.9.5-pre4</a>:
-<dd>Double and half size weren't working properly;
- <br>couldn't use arrow and spacebar to get out of the final Quit
- confirmation dialog (though ESC always worked).
-<dt>10/9/2004, <a href="pho-0.9.5-pre3.tar.gz">Pho 0.9.5-pre3</a>:
-<dd>Fixed a crash bug when revisiting an image which was previously rotated.
- <br>Added a workaround for Metacity's evil window size handling.
- <br>Made the background black when in presentation mode.
-<dt>9/30/2004, <a href="pho-0.9.5-pre2.tar.gz">Pho 0.9.5-pre2</a>:
-<dd>Fixed some bugs involving ending up at the wrong image when
- deleting or pressing HOME. Cleaned up handing of image list.<br>
- Fixed an aspect ratio problem.
-<dt>7/13/2004, <a href="pho-0.9.5-pre1.tar.gz">Pho 0.9.5-pre1</a>:
-<dd>Rewrote the image list handling to use a linked list.
- Lots of associated code cleanup.<br>
- Port to gtk2, and build under either gtk1 or gtk2.<br>
- Add new "fullscreen mode" (e.g. for presentations, or for difficult
- window managers).<br>
- Various futile attempts to hang on to window focus in various window
- managers.
-<dt>9/30/2003, <a href="pho-0.9.2.tar.gz">Pho 0.9.2</a>:
-<dd>Don't try to move the window unless the image size has changed
- (fix the annoying bug where pho wouldn't let you move windows).
- <br>
- Also fix a crash after dismissing the info dialog by clicking
- on the windowmanager "X".
-<dt>2/26/2003, <a href="pho-0.9.1.tar.gz">Pho 0.9.1</a>:
-<dd>Rusty Russell: fix an off-by-one error in rotation code,
- reducing the need for extra memory;
- <br>
- Brian Langenberger: bracket printed filenames with quotes if
- they contain spaces or quote characters.
-<dt>1/8/2003, <a href="pho-0.9.tar.gz">Pho 0.9</a>:
-<dd>Fix pho.spec version, and a make clean bug.
-<dt>12/3/2002, <a href="pho-0.9pre2.tar.gz">Pho 0.9pre2</a>:
-<dd>Fix a crash in the quit dialog.
-<dt>11/27/2002, <a href="pho-0.9pre1.tar.gz">Pho 0.9pre1</a>:
-<dd>Add EXIF handling, using code from
- <a href="http://www.sentex.net/~mwandel/jhead/">jhead, by Matthias Wandel</a>.
-<dt>10/18/2002, <a href="pho-0.8.tar.gz">Pho 0.8</a>:
-<dd>Build RPM and deb; show image size in titlebar; add home key.
-<dt>8/13/2002, <a href="pho-0.7.tgz">Pho 0.7</a>:
-<dd>Put image name in titlebar; prompt after last image before quitting;
- add fullscreen mode.
-<dt>7/28/2002, <a href="pho-0.6.1.tgz">Pho 0.6.1</a>:
-<dd>Fixed a bug with printing a note set on the last image.
-<dt>7/21/2002, <a href="pho-0.6.tgz">Pho 0.6</a>:
-<dd>Code cleanup, change the handling of the notes structures.
-<dt>7/21/2002, <a href="pho-0.5.1.tgz">Pho 0.5.1</a>:
-<dd>Fix a bug where image rotations were wrong when going backward.
-<dt>7/11/2002, <a href="pho-0.5.tgz">Pho 0.5</a>:
-<dd>Add delete dialog, and really delete files on disk.
-<dt>7/3/2002, <a href="pho-0.4.tgz">Pho 0.4</a>:
-<dd>Fixed a bug with gif rotation.
-<dt>7/1/2002, Pho 0.3:
-<dd>Rename yass to pho, add info dialog.
-<dt>6/28/2002, Yass 0.2
-<dd>Some added features; add manual and make install target.
-<dt>6/24/2002, Yass 0.1:
-<dd>First release.
-</dl>
-
<hr>
<a href="../">Akkana's Software</a><br>
<a href="../../">Shallowsky Home</a>

0 comments on commit c4a8f26

Please sign in to comment.