Commit a5c0efda authored by Rafael Laboissiere's avatar Rafael Laboissiere

Import Upstream version 0.5~rc1

parent 11c3399d
$Id: BUGS 236 2009-04-03 22:26:03Z dezperado $
$LastChangedDate: 2015-01-31 17:25:11 +0100 (Sat, 31 Jan 2015) $
==== BUG REPORTING
......@@ -18,7 +18,9 @@ When submitting a bug report, please follow the following rules:
( make ; make report ) 2>&1 | gzip > fim.`date +%Y%m%d%H%M`.log.gz
and send me the created .tgz file
- please give me information about the exact way you experienced the problem
- please give me information about the resolution you are running on
- please give me information about the resolution/video mode you are working with;
from the bash shell, execute the following and send me the output:
( for f in /sys/class/graphics/fb0/* ; do echo $f ; cat $f ; done )
- please send me the config.log file, too (especially if it is a build bug).
it is of vital importance!
(the config.log file is created by the configure script when you run the ./configure script)
......@@ -48,16 +50,28 @@ with a '@' and _Baz_ with a '.'.
==== KNOWN BUGS
20150131 in aalib mode PageUp / PageDown do not seem to work.
20150123
When in framebuffer mode, never, for ANY reason, press C-z (^Z) with the
intention of putting fim in the background. It will blind your console and
allow only blind typing, which is a very dangerous situation!
In windowed aalib setups (that is, when running aalib under X spawns in a separate window), fim is completely unusable.
20110603 Window splitting is disabled.
==== MINOR ISSUES
20090601 under X11, some aalib implementations open a window. well, this breaks readline functionality, when fim is run via aalib under X11 in such an implementation.
20090404 the aalib key binding is not complete and may not be fully portable
20091208 if fim is configured to take input from piped xfig (as xfig-3.2.5b), it could be - passively - subject to
xfig's buffer overflow on files like:
0 1 2 3
4
1 2 3 4 5 6 7 ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
( see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=559274
and http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=xfig_poc.f;att=1;bug=559274)
As long as xfig (fig2dev) is accessed through the popen() system call, there will be no harm to fim from xfig crash.
20091015 In 16 bit graphics mode, some lines which should be white actually look blue (seems not fim' fault; happens on both on ARM and x86)
20091013 fim -i < file.pdf # does not work
20091009 fim does not support 1,2,4 bit modes
20090328 problems with --std=c++98 in legacy src/FbiStuffJpeg.cpp code (now commented)
20070919 while command suffers from being not interruptible in some cases (when the image is small and not 'panable')
20070912 Debugging it with the framebuffer under gdb hangs the console (even with -p).
......@@ -80,6 +94,10 @@ with a '@' and _Baz_ with a '.'.
or trying to get to some X instance via ALT-F7-like sequences, or even restart the computer),
and blind typing could be dangerous, if you do now know what you are doing!
==== OUTSTANDING FIXED ISSUES
20110602 fim versions before svn version r373 segfault in 32 bit framebuffer mode, on 64 bit builds
==== FIXED FBI/FBGS ORIGINATING BUGS
Replaced popen with pipe calls : http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=422034, in rev. 213.
......@@ -95,8 +113,12 @@ with a '@' and _Baz_ with a '.'.
==== UNFIXED EXTERNALLY ORIGINATING BUGS
20090329 On my debian box's aalib, the ascii art driver leaks 224 bytes of memory.
20090329 On my debian box's aalib, the ASCII art driver leaks 224 bytes of memory.
Actually, it happens the same when compiling aalib-1.4.0's aafire.c program against debian aalib
and running it in console mode (no X).
After clean aalib recompilation, these problems vanish.
==== SOLVED ISSUES
20110712 in sdl (x11) mode, when fim is spawned in a non-terminal environment, the readline mode does not work in the proper way. detecting this situation may be helpful to disable the readline mode at all in these cases, until a readline-centric fix is found. (seems fixed with r688)
This source diff could not be displayed because it is too large. You can view the blob instead.
This diff is collapsed.
# This file should be processed with automake..
#
# $Id: Makefile.am 246 2009-04-28 22:15:34Z dezperado $
#
# inspired by mutt's Makefile.am
#
# yet not optimal
# $Id: Makefile.am 962 2016-01-30 15:39:32Z dezperado $
# no-dependencies was due to problems with conditional sources
# nostdinc disables the standard -I. include which breaks a correct string.h include
AUTOMAKE_OPTIONS = nostdinc no-dependencies # dejagnu
SUBDIRS = src doc distros scripts
dist_doc_DATA=README README.FIRST TODO VERSION BUGS FAQ.TXT AUTHORS ChangeLog NEWS
dist_doc_DATA=$(top_srcdir)/README $(top_srcdir)/README.FIRST $(top_srcdir)/TODO $(top_srcdir)/VERSION $(top_srcdir)/BUGS $(top_srcdir)/FAQ.TXT $(top_srcdir)/AUTHORS $(top_srcdir)/ChangeLog $(top_srcdir)/NEWS
# no INSTALL INSTALL.TXT is necessary in rules
EXTRA_DIST= COPYING \
Makefile.am configure.ac configure \
aclocal.m4 config.h.in \
autogen.sh \
media/image.jpg \
media/image.png \
media/fim.png \
$(top_srcdir)/media/image.jpg \
$(top_srcdir)/media/image.png \
$(top_srcdir)/media/fim.png \
$(top_srcdir)/var/fonts/Lat15-Terminus16.psf \
depcomp missing install-sh
FIM_EXE=./src/fim
FIMGS_EXE=./src/fimgs
# mhmhmhm
# CLEANFILES = autom4te.cache
......@@ -44,31 +42,40 @@ signed-dist: dist
# gpg -sbav -u EF1258B8 $@ $<
# this rule is deprecated, too: testing should be performed with 'make tests'
FIMNORCOPTS=-N --no-etc-rc-file
# this rule is deprecated, too: testing should be performed with 'make tests' (FIXME)
sanity-check: all
@./src/fim -E scripts/tests/sanity.fim -t
@$(FIM_EXE) $(FIMNORCOPTS) -E $(top_srcdir)/scripts/tests/sanity.fim -t
# this should be the preferred way of testing, now on
# this is the official way of testing fim
tests: all
@cd ./src/testdir && make
ulimit -c unlimited || true
ulimit -v 32000 || true
ulimit -t 1000 || true
@top_srcdir=$(top_srcdir) $(SHELL) $(top_srcdir)/scripts/tests/version.sh
@top_srcdir=$(top_srcdir) $(SHELL) $(top_srcdir)/scripts/tests/font.sh
@$(FIM_EXE) $(FIMNORCOPTS) -o dumb -E $(top_srcdir)/scripts/example/oneline.fim -c quit
@$(FIM_EXE) $(FIMNORCOPTS) -o dumb -c 'quit 14' ; if test $$? == 14 ; then echo '[*] Error code return test PASSED' ; else echo 'Error code return test FAILED'; false ; fi
if test $(abs_builddir) = $(abs_srcdir) ; then make -C src/testdir ; fi
FIMSCRIPTSDIR=`pwd`/scripts/maintenance/
# new target, still not working
tests-all: tests $(FIMSCRIPTSDIR)/configure-brute-check.sh
cd src && which cppcheck && cppcheck *cpp *.h || true
$(FIMSCRIPTSDIR)/configure-brute-check.sh
$(SHELL) $(FIMSCRIPTSDIR)/configure-brute-check.sh
#news-dump:
# awk -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS > f
# $(AWK) -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS > f
# this rule is deprecated, too
test: all
@./src/fim -N media/* #~/M*s/*g
@$(FIM_EXE) $(FIMNORCOPTS) $(top_srcdir)/media/* #~/M*s/*g
# this rule is deprecated, too
aatest: all
@./src/fim -N media/* -o aa #~/M*s/*g
@$(FIM_EXE) $(FIMNORCOPTS) $(top_srcdir)/media/* -o aa #~/M*s/*g
# this rule is old and deprecated
#tgz: clean
......@@ -107,24 +114,34 @@ help:
@echo ' short Makefile help'
@echo -----------------------------------------------
@echo
@echo 'Please read the doc/FIM.TXT file before complaining!'
@echo 'Please read the documentation file before complaining!'
@echo
@echo '..or README, or INSTALL, or some other file around here. There is plenty!'
@echo '...'
@echo 'The first documentation file you should read is README'
@echo
@echo 'If you are experiencing problems, please write at dezperado, the author of fim.'
@echo 'If you are experiencing problems, please contact the code author.'
@echo
@echo 'His mail box resides as dezperado , on the server autistici dot org.'
@echo
@echo 'You are encouraged to read the documentation before, and emailing the output of `make report`!'
@echo 'Thanks for your collaboration'
@echo 'His mail box resides as dezperado, then a dot, then autistici dot org.'
@echo
@echo 'You are encouraged attaching the output of `make report` in your bug reports.'
@echo 'Thanks for your collaboration.'
@echo
ai:
make site up -C var/
up: upload news
news: freshmeat mail-announce
dox: doc/fim.man doc/fimrc.man doc/fimgs.man
MANSUBST = sed -e 's,@sysconfdir\@,$(sysconfdir),g' -e 's,@docdir\@,$(docdir),g' -e 's,-,\\-,g'
doc/fim.man doc/fimrc.man doc/fimgs.man: $(FIM_EXE)
$(FIM_EXE) $(FIMNORCOPTS) --help=m |$(MANSUBST) > doc/fim.man
$(FIM_EXE) $(FIMNORCOPTS) --dump-reference-help=man |$(MANSUBST) > doc/fimrc.man
$(FIMGS_EXE) -m -- $(FIMNORCOPTS) |$(MANSUBST) > doc/fimgs.man
# fixme : missing integration with ChangeLog file
mail-announce:
@ figlet fim | mutt -s "fim-`cat VERSION` release" "fbi-improved-devel@nongnu.org" -i -
......@@ -148,7 +165,7 @@ savannah-lookup:
# fixme : missing integration with ChangeLog file and such information
freshmeat_old:
@ awk -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS
@ $(AWK) -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS
@echo freshmeat-submit -v "fbi-`cat VERSION`" \
--project fbi-improved \
--license GPL \
......@@ -159,7 +176,7 @@ freshmeat_old:
--mirror-site-url $$(cat README | grep "^Off.*rror : "|sed s/^.*\ :.//g) \
--changelog-url $$(cat README | grep "^ChangeLog "|sed s/^.*\ :.//g)
@ echo "are you sure ? (any key to abort, yes to continue)" && read yes && [[ "$${yes}" == "yes" ]] && \
awk -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS | \
$(AWK) -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS | \
freshmeat-submit -v "fbi-`cat VERSION`" \
--project fbi-improved \
--license GPL \
......@@ -186,7 +203,7 @@ freshmeat-submit:
@echo ChangeLog-URL: $$(cat README | grep "^ChangeLog "|sed s/^.*\ :.//g)
@echo CVS-URL: $$(cat README | grep "^Repository"|sed s/^.*\ :.//g)
@echo
@ awk -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS
@ $(AWK) -- 'v=0;($$1 == "Version" && $$2=="'`cat VERSION`'"){while((input=getline) && $$1!="Version"){print}};' NEWS
freshmeat:
@ echo "are you sure you want to freshmeat-submit ? (any key to abort, yes to continue)" && read yes && [[ "$${yes}" == "yes" ]] && \
......
This diff is collapsed.
FIM NEWS -- history of user-visible changes in FIM.
FIM NEWS -- history of (main) user-visible changes in FIM.
Version 0.5-rc1
* fix: enabled concurrent make, e.g.: make -j 4
* bug workaround: had no console scroll if no command executed on PostInteractiveCommand
* fix: some systems don't have sys_errlist: using strerror there
* fix: corrected the quiet mode (-q) to be quieter
* fix: no zlib.h build time dependency (this will be reintroduced in the future)
Version 0.5-rc0
* -R / --recursive switch to turn on recursive push of command line specified directories
* added --sort and --sort-basename to sort the images list
* introduced mipmap mechanism (_use_mipmaps) for faster display/scaling of images
* status bar customizable with _display_status_fmt and _info_fmt_str, which can be
controlled by the use of special image variable specifiers ('expandos'):
"%T" expando to get (and display) total memory used by the program
"%C" expando to get (and display) file/memory usage by image cache
"%M" expando to get (and display) memory used by the current (displayed) image
"%c" expando to get (and display) centering information
"%m" expando to get (and display) current image mipmap occupation information
"%k" expando to get (and display) current image i:_comment value
"%?PRE?VAR?POST?" expando to get (and display) "PRE".i:VAR."POST"
...
* search (and jump) on image descriptions via 'goto' and key '/'
* when repeating search with 'repeat_last', will use last direction
* '?' key is now assigned to backward search (goto '-//')
* default 'C-p' key is now assigned to repeat last backward search (goto '-//')
* image cache will remember alignment within viewport
* jump back and forth from the last viewed image with the ' (single quote aka apostrophe)
key and the _lastfileindex variable
* added --load-image-descriptions-file (equivalent to 'desc' 'load') to populate
the i:_comment values of each loaded image file and set _caption_over_image=2
(with it added also --image-descriptions-file-separator)
* added the 'desc "load"' command to load a textual files comments description file
* introduced a 'limit' command, with comment, file name, or marked file criteria
* the '`' key is bound to toggle limit'ing to the marked files list
* introduced 'list "mark"' and 'list "unmark"' syntax styled as 'limit'
* load i:_comment and i:var from description file, with forms:
"filename comment" (to i:_comment),
"#!fim:var=value" (to set i:var=value on all all the files following)
"#!fim:var=" (to unset i:var=value on all all the files following)
"filename #!fim:=" (to i:_comment from the value read last)
"filename #!fim:+comment" (similar, but will append the new comment)
"filename #!fim:^comment" (similar, but will prepend the new comment)
"filename #!fim:s/f/t" (similar, but replace string f with string t)
* EXIF tags will be read with libexif and become i:EXIF_-prefixed variables
* if _want_exif_orientation is set, images will be reoriented according to EXIF
metadata (i:__exif_orientation, i:__exif_mirrored, i:__exif_flipped).
* the 'help' command will search also in fim command options
* will optionally use C++11 constructs with ./configure --enable-cxx11 (no user level impact)
* scaling image code faster (thanks to __restrict__ pointers)
* customizable SDL window caption line with _want_wm_caption_status
* BMP format support is now optional
* PCX format support (optional)
* changed meaning of variable _ignorecase: now it affects autocommands
* introduced variable _re_search_opts affecting regexp-based search
* default key 'r' is bound to 'rotate90', key 'R' to 'rotate270'
* can be invoked without stdin; e.g. from an X menu
* added "display 'resize'" to resize the SDL window, eventually to image size
* default SDL mode is windowed now
* by default, the 'C-w' key will resize the SDL window to the original image size
* by default, the 'W' key will resize the SDL window to the image size,
and added an --autowindow switch to adapt window size to picture size
* the 'help' command will search in help items if argument starts with /
* special variable i:* expanding to all the variable name/value pairs of the current image
* opening image files in archives (e.g. CBZ,CBR,RAR,TAR,TGZ,TBZ,7Z,ISO,...)
with libarchive (experimental)
* JPEG-2000 file support via JasPer (experimental)
* added a ':- INTEGER' syntax, so one can specify the file in the list counting from the end
* added an _archive_files variable to specify which file name types specify archives
* added a 'list "pushdirr"' command, working like "pushdir" but recursively
* the _fbfont variable will contain the current console font file string
* mirror/flip are now being applied with respect to the viewport borders
* stat() checking of files on load can be disabled with _push_checks
* added --no-stat-push to set _push_checks=0 before initialization
* added the _caption_over_image variable (which is 0 unless --load-image-descriptions-file)
* 'Pause' and 'Menu' keys are now available in SDL (-o sdl) mode
* added 'list' 'marked' to show the list of marked files
* key 'Del' bound to pop (delete) the current image from the list
* i:_file loader will store the used loader string
* switch --offset accepts a range now (using the new _open_offset_retry variable)
* if an image has been opened with an offset, i:_open_offset will be set accordingly
* variable i:pagecount is now replaced by i:pages
* put aside (disabled) the v: b: and w: namespaces until they make more sense
* panning on mouse movement in SDL mode
* `make fim' goal has been deleted
* changed librsb library detection: now it's e.g.:
LIBS="`librsb-config --ldflags --extra_libs` " CXXFLAGS="`librsb-config --cflags ` \
./configure --enable-matrices-rendering
* bugfix: in some situations fim -o fb was not clearing the screen before drawing the image
* bugfix in the "list 'remove'" internals
* --binary=1/--binary=24 will not pad tiny renderings to _preferred_rendering_width pixels
Version 0.4
* changed --random semantics and introduced --random-no-seed switch
* customizable status bar file info string
* introduced --as-text to render printable bytes as text
* key r is bound to 'rotate90', key R to 'rotate270'
* bug fixes for the g: namespace, SDL/X mode, "list 'pop'" command,
the --offset option, 'ascale' and rotation, documentation.
Version 0.4-beta
* interface to the GraphicsMagic library (more graphics formats supported)
* introduced bitwise AND and OR operators
* support for rendering "matrix market" numerical matrix files (with librsb)
* X mode not anymore default in aalib, available at option
* libjpeg usage fixes
* libpng usage fixes (support for PNG_LIBPNG_VER>=10209)
* documentation improvements (e.g.: fim man page is auto-generated)
* "imlib2" X-based output device support
* "sdl" output device improvements (fullscreen/mouse/windowed options, I/O, ..)
* more default consolefont options (e.g.: hardcoded consolefonts support)
* configure option to disable the fim history file
* improvements to scale, goto, other commands
* improved directories reading
* introduced --no-commandline, --no-internal-config switches
* aggregated some commands for clarity
* output console can be disabled at configure time
* important fbdev bug fixes
* autocompletion of variable identifiers
Version 0.3
* minor strchr compilation problem on some systems
* better consolefonts support
* much better SDL support (different color modes)
* 'negate' feature
* -S, or 'sanity-check' switch
Version 0.3-beta-prerelease
* auto-generated documentation: more consistency
* grammar specification, in man fimrc
* internal commands,variables,autocommands reference man page, in man fimrc
* better internal help mechanisms
* more control (resolution change,windowed mode) in experimental sdl mode
* new commands (pread,reverse,shuffle,...)
* (temporarily) disabled internal windows splitting
* pushing files from a directory
* several minor and major bugfixes
Version 0.3-beta
......@@ -11,6 +154,7 @@
* viewing of any type files as bitmaps (unset bits black, set bits white)
* viewing of any type files as pixmaps (as RGB triples)
* framebuffer driver now can be disabled at compile time
* colors inversion: saves a significant fraction of power when viewing documents
Version 0.3-alpha
......
This diff is collapsed.
......@@ -2,7 +2,7 @@
FIM Quick start ( the happy path ) :
--------------------------------------------------------------------------------
in the fim directory , issue:
in the fim directory, invoke:
# make
# make test
......@@ -12,59 +12,51 @@ in the fim directory , issue:
And in order to have a *working* configuration file, issue:
# cp fimrc ~/.fimrc
( the configuration file is essential to the proper working of FIM )
( a correct configuration file --- if at all --- is essential to the
proper working of FIM )
--------------------------------------------------------------------------------
BUILDING
--------------------------------------------------------------------------------
Do not worry if you see warning or error messages :) ..
The important thing is that the fbi executable gets built :)
If you get problems with compilation, please send me an email with
the output of:
# make report
Problems may arise if fbi fails finding its libraries..
(FSlib for example, with is(sadly) an X extension!)
Problems may arise if fim fails finding its libraries..
--------------------------------------------------------------------------------
USAGE
--------------------------------------------------------------------------------
There is no documentation currently about the internal language, as i have
There is no good documentation currently about the internal language, as i have
not yet finished working on it.
But to get warm with FIM, it is indicated to use the commands in the fimrc file.
But to warm up with FIM, it is indicated to use the commands in the fimrc file.
The ./fimrc file is the one fim loads at startup.
It contains commands that bind keys to commands, aliases and such things.
WARNING : DO NOT START FIM WITHOUT THE fimrc FILE IN THE CWD, OR IT WILL NOT HAVE
ANY KEY BINDING !
WARNING : DO NOT QUIT FIM WITH CONTROL-C ! IT COULD BROKE YOUR CONSOLE AND YOU SHOULD
DO DIRTY TRICKS TO RESTORE ITS GRAPHICS CAPABILITIES. USE q INSTEAD!
WARNING : DO NOT QUIT FIM WITH CONTROL-C ! IT CAN BREAK YOUR CONSOLE AND YOU
WILL NEED TO DO DIRTY TRICKS TO RESTORE ITS GRAPHICS CAPABILITIES.
USE q INSTEAD!
WARNING : DO NOT QUIT FIM WITH CONTROL-D ! AS ABOVE
WARNING : DO NOT USE THE BINDINGS CONTROL-C, CONTROL-D, CONTROL-S, as they are
probably already signal-bound by the underlying terminal!!
TIP : If the program hangs and gets terminated, leaving the console useless, DON'T PANIC!
If you have 'fbi' installed, don't try to switch console and type blindly 'fbi *' even
if you don't see anything. This will call 'fbi', and probably restore the console!
Don't try to switch console -- better type blindly 'fim *' (or its path)
even if you don't see anything. This will restart it, and probably restore the console!
Invocation : ./fim picture.jpg ..
There is no proper --help option yet..
Default configuration bindings ( hardcoded :) ) :
Default configuration bindings:
q quit
d displays
r reload
hjkl as in vim :)
n/PageUp next
p/PageDown prev
a auto scale
C-a auto scale
w auto width scale
: enter command line mode
Enter exit command line mode
......
Thanks go to (in temporal order, newer to older):
Mohammed Isam, for having provided PCX reading support
Matthieu Crapet, for enabling out-of-tree builds
Marco Barbàra, for testing and critiques
Vitaly Minko, for testing and debugging on ARM
Damiano Biagioli, for early testing
Marta Carbone, for early testing and debugging
This diff is collapsed.
0.3-beta-prerelease
0.5-rc1
This diff is collapsed.
#!/bin/sh
# $Id: autogen.sh 150 2008-09-30 13:53:26Z dezperado $
# $LastChangedDate: 2011-05-23 14:51:20 +0200 (Mon, 23 May 2011) $
# This file is still not complete.
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
# $Id: Makefile.am 211 2009-02-18 00:14:52Z dezperado $
# $Id: Makefile.am 537 2013-03-22 20:08:54Z dezperado $
#
# The local Manifest building code is not enough
......@@ -32,5 +32,5 @@ all:
ebuild: $(PREFIX)/Manifest
clean:
rm -fRd $(PREFIX)/Manifest $(PREFIX)/files
rm -fR $(PREFIX)/Manifest $(PREFIX)/files
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
# $LastChangedDate: 2015-12-20 12:24:29 +0100 (Sun, 20 Dec 2015) $
# $Id: Makefile.am 245 2009-04-28 21:28:38Z dezperado $
HTMLDOCS=FIM.html fim.man.html fimgs.man.html fimrc.man.html
CLEANFILES= doctags *.o tags
CLEANFILES= doctags *.o tags $(HTMLDOCS)
HTMLDOCS=FIM.html fim.man.html fimgs.man.html
EXTRA_DIST = FIM.TXT fim.man doctags.c fim-stylesheet.css ./vim2html.pl fimgs.man
EXTRA_DIST = FIM.TXT fim.man doctags.c fim-stylesheet.css ./vim2html.pl fimgs.man fimrc.man
#MAN2HTML=man2html
MAN2HTML=$(MAN) --html=cat
MAN2HTMLS = sed 's/&minus;/-/g'
man1_MANS = fim.man fimgs.man
man5_MANS = fimrc.man
# html stuff is installed in the documentation directories, too
htmldir = $(docdir)
dist_html_DATA = $(HTMLDOCS)
dist_doc_DATA = FIM.TXT
all: $(EXTRA_DIST)
htmldocs: $(HTMLDOCS)
#docs: $(HTMLDOCS)
all: $(HTMLDOCS) $(EXTRA_DIST)
FIM.html fim-stylesheet.css: doctags FIM.TXT
./doctags FIM.TXT > tags ; ./vim2html.pl tags FIM.TXT
./doctags $(srcdir)/FIM.TXT > tags ; $(srcdir)/vim2html.pl tags $(srcdir)/FIM.TXT
fim.man.html: fim.man
man2html fim.man > fim.man.html || echo "$(ERRMSG) man2html fim.man > fim.man.html"
$(MAN2HTML) ./$< | $(MAN2HTMLS) > $@ || $(ECHO) "$(ERRMSG) $(MAN2HTML) $< > $@"
fimrc.man.html: fimrc.man
$(MAN2HTML) ./$< | $(MAN2HTMLS) > $@ || $(ECHO) "$(ERRMSG) $(MAN2HTML) $< > $@"
ERRMSG="no man2html at build time : please install man2html and reissue :"
ERRMSG="No $(MAN2HTML) at build time : please install $(MAN2HTML) and reissue :"
fimgs.man.html: fimgs.man
man2html fimgs.man > fimgs.man.html || echo "$(ERRMSG) man2html fimgs.man > fimgs.man.html"
$(MAN2HTML) ./$< | $(MAN2HTMLS) > $@ || $(ECHO) "$(ERRMSG) $(MAN2HTML) $< > $@"
doctags:
$(CC) -o doctags doctags.c
doctags: doctags.c
$(CC) -o $@ $<
#clean:
# rm -f doctags.o doctags FIM.html tags fim-stylesheet.css fim.man.html fimgs.man.html
# $(RM) -f doctags.o doctags FIM.html tags fim-stylesheet.css fim.man.html fimgs.man.html
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
.\" $Id: fimgs.man 220 2009-02-25 02:47:27Z dezperado $
.TH fimgs 1 "(c) 2007-2009 Michele Martone"
.TH fimgs 1 "(c) 2007\-2011 Michele Martone"
.SH NAME
fimgs - poor man's [http://]PostScript/pdf/dvi/cbr/rar/cbz/zip viewer for the linux
fimgs \- poor man's [http://]PostScript/pdf/dvi/cbr/rar/cbz/zip viewer for the linux
framebuffer console
.SH SYNOPSIS
.B fimgs [ options ] file
.B fimgs [ {fimgs\-options} ] file [\-\- [{fim\-options}]]
.SH DESCRIPTION
.B fimgs
is a simple wrapper script which takes a PostScript or pdf
or .cbr or .rar or .cbz or .zip or .dvi
or any of the above
prefixed with http://
as input, renders the pages using ghostscript into a
temporarely directory and finally calls fbi to display them.
In case of compressed archives (in zip or rar formats), the images
are decompressed into a directory and displayed.
In this latter case, only images contained in the archive will be displayed
(no nested archives or pdf's or ps's or dvi's).
is a simple wrapper script which takes a PostScript or pdf or .cbr or .rar or .cbz or .zip or .dvi or any of the above prefixed with http:// or https:// or ssh:// as input, renders the pages using ghostscript into a temporary directory and finally calls \fB fim\fP to display them.
In case of compressed archives (in zip or rar formats), the images are decompressed into a directory and displayed using \fB fim\fP.
In this latter case, only images contained in the archive will be displayed (no nested archives or pdf's or ps's or dvi's).
The temporary directory name is taken from the $TMPDIR environment variable.
.SH OPTIONS
.\" fimgs understands all fim options (they are passed through).
.B fimgs
still does not understand all of fim's options (they are not passed through).
so please use
.B fimgs -h
to get help on its options.
To pass through options to \fB fim\fP, you may specify them after "\-\-".
.\" Additionally you can specify -l, -xl or -xxl to get the pages
.\" rendered with 100, 120 or 150 dpi (default is 75).
.B \-r {resolution}
Specify resolution for the 'gs' \-r option (e.g.: 96x96; default 120x120).
.TP
You can
use option -p <password> if your PDF file requires password.
.B \-m
Dump a man page for fimgs.
.TP
.B \-p {password}
Specify password for the 'gs' \-p (password) option.
.TP
.B \-h
Will display a help message.
.\" Additionally you can specify \-l, \-xl or \-xxl to get the pages
.\" rendered with 100, 120 or 150 dpi (default is 75).
.SH SEE ALSO
fim(1), gs(1), fbi(1), fbgs(1), bash(1)
fim(1), fimrc(1), gs(1), fbi(1), fbgs(1), bash(1)
.SH AUTHOR
Michele Martone <dezperado _ GUESS _ autistici.org>.
Content-type: text/html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of fimgs</TITLE>
</HEAD><BODY>
<H1>fimgs</H1>
Section: User Commands (1)<BR>Updated: (c) 2007-2009 Michele Martone<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
fimgs - poor man's [<A HREF="http://]PostScript/pdf/dvi/cbr/rar/cbz/zip">http://]PostScript/pdf/dvi/cbr/rar/cbz/zip</A> viewer for the linux
framebuffer console
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>fimgs [ options ] file</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>fimgs </B>
is a simple wrapper script which takes a PostScript or pdf
or .cbr or .rar or .cbz or .zip or .dvi
or any of the above
prefixed with http://
as input, renders the pages using ghostscript into a
temporarely directory and finally calls fbi to display them.
In case of compressed archives (in zip or rar formats), the images
are decompressed into a directory and displayed.
In this latter case, only images contained in the archive will be displayed
(no nested archives or pdf's or ps's or dvi's).
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<B>fimgs</B>
still does not understand all of fim's options (they are not passed through).
so please use
<B>fimgs -h</B>
to get help on its options.
<P>
<P>
You can
use option -p &lt;password&gt; if your PDF file requires password.
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+fim">fim</A>(1), <A HREF="/cgi-bin/man/man2html?1+gs">gs</A>(1), <A HREF="/cgi-bin/man/man2html?1+fbi">fbi</A>(1), <A HREF="/cgi-bin/man/man2html?1+fbgs">fbgs</A>(1), <A HREF="/cgi-bin/man/man2html?1+bash">bash</A>(1)
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Michele Martone &lt;dezperado _ GUESS _ autistici.org&gt;.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>