pkg://nolce-1.7-2.i386.rpm:32168/usr/man/man1/nolce.1  info  downloads

.TH nolce 1 "9 November 1997" "Nolce version 1.7-2" \" -*- nroff -*-
.SH NAME
nolce - allow off-line Netscape Navigator cache browsing
.SH USAGE
.B nolce
[n_hours] [-c cache_dir] [-d dest_dir] [-g|-G sub_string] [-i summary_file] [-w|-W] [-s] [-m] [-t] [-f] [--help]
.SH DESCRIPTION
Nolce copies Netscape Navigator (ver. 2 and above) cache files 
in a new directory, adjusting file names and links to permit an off-line 
navigation of them. 
.SH OPTIONS
.TP
.I "n_hours"
Process only files created, that is downloaded, in the last n_hours hours.
If this option isn't given, nolce processes all the files of the cache.
.TP
.I "-c cache_dir"
Process cache files under the cache_dir directory. Default is
.BR $HOME/.netscape/cache .
.TP
.I "-d dest_dir"
Store processed files under dest_dir. Default is 
.BR $HOME/cached . 
.TP
.I "-g sub_string"
Process only HTML files whose URL contains the specified sub_string
.TP
.I "-G sub_string"
Process only HTML files whose URL doesn't contain the specified sub_string
.TP
.I "-i summary_file"
Put summary about documents retrieved in the html file summary_file. It will
contain titles of documents, and links both to local copy and to
original site of them. Even if it's given an absolute path, the file will
be always created in dest_dir. Default is
.BR index.html .
If summary file exists, it is not overwritten, but new entries are appended to 
it.
.TP
.I "-w, -W"
By default pages are displayed in the summary window. With
.BR -w
another browser window is created for pages, while with
.BR -W 
they are displayed in the list frame.
.TP
.I "-s"
Programs executes silently.
.TP
.I "-m"
By default, missing images are totally eliminated from the HTML file, so one doesn't see 
the Netscape icon indicating them. With this option, missing
images are kept.
.TP
.I "-t"
Put downloading date of each document in summary file.
.TP
.I "-f"
Don't process links not satisfying initial conditions.
When one of the options 
.BR n_hours , 
.BR -g 
or 
.BR -G  
is given, if a document has a link to another one which doesn't satisfy those 
conditions, the link is processed also, unless the -f option is
given. However, even when processed, these links doesn't appear in the summary
file.
.TP
.I "--help"
Shows help message and exit.
.SH OVERVIEW
Netscape normally stores all types of downloaded documents (html files, images and so
on) under the directory $HOME/.netscape/cache, but it changes their names and
their relative position, so it isn't possible to browse them off-line.
.PP
Nolce basically does three things: copies cached files in a new directory 
structure which reflects the original site structure, restores their original 
file names, and adjusts links in html files to point to local files rather than
to Internet ones. 
.I The original Netscape cache is left intact.
After running the program, user should open the summary
file in Netscape Navigator, and from it view desired documents.
Alternatively one can explore the directories and files created under
dest_dir.
.PP
When viewing processed documents, links in 
.I italics 
refer to local documents,
while normal links to Internet ones.
.PP
For further informations see the next section.
.SH FILES
This software comes with a LICENCE file and a README file in the HTML format.
Refer to them for further informations, especially to 
the section `HOW IT WORKS' for knowing how the program acts and what it does 
and doesn't.
.SH AUTHOR
Giuseppe Trovato (g.trovato@usa.net)