Sergio: Without a patch I'd close this as WONTFIX if I was a maintainer...

Considering eog's manual also needs an update regarding its content this could possibly be done in the same run.

Work on this started on master:

http://git.gnome.org/browse/eog/commit/?id=9ec30ae9a87cc0b39ec42d26cc948e690e0730d8

Nice. I like the outline you have plotted, Tiffany. There's even some points I didn't even think of putting them into the docs, like the commandline and the keyboard shortcuts (yay, finally a place where we can list all those secret shortcut keys). :)

Hi Felix :-).  Can you tell me if the 'Edit image' button is available in a all distros, or just some?

(In reply to comment #5)
> Hi Felix :-).  Can you tell me if the 'Edit image' button is available in a all
> distros, or just some?

It's not available by default. The distro has to specifically enable it by settings an editor. From what I know no distro shipping 3.0 does this yet. The only distro I know that uses it at the moment is Ubuntu, but they patch a 2.32 release especially for this.

Yet all distros have the "Open With..."-list in the "Image"-menu. Just to avoid a possible misunderstanding. :)

Mallard pages completed.  Now just need review.  Makefile.am updated and committed
by Ryan Lortie.

I had quick look over it and fixed a few typos as I spotted them, but nothing major. Also the figures where recompressed using OptiPNG and PNGOUT which made them smaller by ~10% in total.

I'll try to have a deeper look tonight. :)

awesome :-)

Just a few things so far:

In the section about zooming it would be good if there would be a short explanation that while "Best Fit" follows the window size it will only change the zoom factor at most to 100%. It won't zoom in any further to have smaller images fill a large window. There were often some misconceptions about that behavior before.

The sections "Convert multiple images" and "Rename many images at once" could be linked, mentioning something like that the same dialog could also be used for the other function. Also when renaming it should be mentioned that one should make sure the file format box says "as is" or it won't be a simple rename anymore.

The section "Flip and rotate" reminds the user to save the changes. Should we tell him how to actually save or is it okay to assume common knowledge here?

Maybe a little sidenote to the "Printing an image" section: The position of the image on the page can also be adjusted by dragging it around in the preview.

"Keyboard Shortcuts": Ctrl+W doesn't really close eog, but just the current window. Not sure if this should be changed or if the user should believe he has multiple instances (window=instance) open although they are one process.
Also: Ctrl+Shift+= zooms in (although not sure why) but Ctrl++ should probably be listed here to stay in line with zooming out. Note that the + and - work also alone for zooming, I think the Ctrl was just used because the HIG told us so.

"The Command Line": Opening an image in slideshow mode doesn't make much sense. ;)
What happens is that all the images in the folder will be shown in the slideshow. It makes more sense to just give the folder to be shown as parameter there.

That's all I found so far. :)

(In reply to comment #10)
> Just a few things so far:
> 
> In the section about zooming it would be good if there would be a short
> explanation that while "Best Fit" follows the window size it will only change
> the zoom factor at most to 100%.

I agree.  done.

> The sections "Convert multiple images" and "Rename many images at once" could
> be linked, mentioning something like that the same dialog could also be used
> for the other function. Also when renaming it should be mentioned that one
> should make sure the file format box says "as is" or it won't be a simple
> rename anymore.

done. 

> The section "Flip and rotate" reminds the user to save the changes. Should we
> tell him how to actually save or is it okay to assume common knowledge here?

Some apps (namely Shotwell) do not require explicitly saving rotate changes, therefore I don't think it can be assumed to be common knowledge (since it's not always necessary).  Having said that, eog does ask if you are sure you want to close without saving the changes, reminding the user to save anyways.  So not sure.  Left it alone for now.  If you think the instruction should be removed I will do so. :-)

> Maybe a little sidenote to the "Printing an image" section: The position of the
> image on the page can also be adjusted by dragging it around in the preview.

Sidenote added.

> "Keyboard Shortcuts": Ctrl+W doesn't really close eog, but just the current
> window. Not sure if this should be changed or if the user should believe he has
> multiple instances (window=instance) open although they are one process.
> Also: Ctrl+Shift+= zooms in (although not sure why) but Ctrl++ should probably
> be listed here to stay in line with zooming out. Note that the + and - work
> also alone for zooming, I think the Ctrl was just used because the HIG told us
> so.

Done.  I didn't know it worked without the Ctrl (The Ctrl is stated in the menu).
 
> "The Command Line": Opening an image in slideshow mode doesn't make much sense.
> ;)
> What happens is that all the images in the folder will be shown in the
> slideshow. It makes more sense to just give the folder to be shown as parameter
> there.

Agree. Changed example.


Thanks for your quick feedback :-) Let me know what other changes I can make to make these docs awesome!

Cheers.

Just finished polishing these docs up with Shaun McCance (on Master).  Closing this bug.

Thanks a lot, Tiffany ( & helpers) . :)