1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
|
.TH DEJASEARCH 1 1999-12-09
.SH NAME
dejasearch \- A front-end to the deja.com Usenet search engine
.SH SYNOPSIS
.B dejasearch
.RI [ options "] " query_string
.SH DESCRIPTION
DejaSearch is a frontend to Deja.com (http://www.deja.com/), the leading
Usenet archive and search engine. Deja.com is a great resource to uncover
even the most obscure information from the sea of data that is Usenet. I
frequently use it to find answers to technical problems, or to learn about
how people rate particular products before making a more informed purchase.
.PP
DejaSearch will submit a search for you to Deja.com, then retrieve and
consolidate all search results into one single HTML file, sorted in
newsgroup, subject and date (reverse) order. This means related messages will
be closer to one another, with the more recent messages nearer to the top.
This also means you can print out the entire file and read the messages at
your leisure, instead of having to go through them one by one on the screen.
.SH OPTIONS
.TP
.BR "-format new" | classic | mbox
Interface to use (default: \fBnew\fP).
.TP
.BR "-fromdate " date
Date to limit search from (eg. \fBApr+1+1997)\fP).
.TP
.BR "-todate " date
Date to limit search to (eg. \fBApr+8+1997)\fP).
.TP
.BI "-max " num
Maximum number of messages to retrieve
.if n .br
(default: 99,999).
.TP
.B -nostatus
Opposite of \fB-status\fP.
.TP
.B -noverbose
Opposite of \fB-verbose\fP.
.TP
.BI "-output " filename
Name of output file (default: \fBsummary.html\fP).
.TP
.BI "-proxy " URL
Proxy server in http://hostname:port format.
.if n .br
Overrides the \fBhttp_proxy\fP environment variable.
.TP
.BI "-sleep " num
Wait \fInum\fP seconds between requests, to avoid being tagged as a robot.
.TP
.B -status
Display download status (default: true).
.TP
.BR "-type recent" | past | all
Archive to use (default: \fBall\fP).
.TP
.BR -verbose
Display search status (default: true).
.SH "DEJA.COM SEARCH LANGUAGE QUICK REFERENCE"
The query string is made of keywords mixed with the following special
characters:
.ie n .ta 4 29 36
.el .ta 4 20
\fIOp\fP \fIDescription\fP \fIExample\fP
.br
\fB&\fP Logical \fIand\fP "\fBbeans & rice\fP"
.br
\fB|\fP Logical \fIor\fP "\fBcamel | llama\fP"
.br
\fB&!\fP Logical \fIand-not\fP "\fBclam &! chowder\fP"
.br
\fB^\fP Near "\fBsteven ^ spielberg\fP"
.br
\fB""\fP Quote marks "\fBthe far side\fP"
.br
\fB*\fP Match any string "\fBpsych*\fP"
.br
\fB?\fP Match any character "\fBgr?y\fP"
.br
\fB[]\fP Match c. in set/range "\fBgr[ae]y\fP"
.br
\fB()\fP Grouping "\fBscully & (xfiles | x-files)\fP"
.br
\fB{}\fP Match any string between bounds "\fB{monkey monkeying}\fP"
.br
\fB~a\fP Author "\fB~a demos@deja.com\fP"
.br
\fB~s\fP Subject "\fB~s chess\fP"
.br
\fB~g\fP Newsgroup "\fB~g alt.love\fP"
.br
\fB~dc\fP Creation date "\fB~dc 1996/12/31\fP"
.PP
\fBAND\fP, \fBOR\fP, \fBAND NOT\fP and \fBNEAR\fP are synonymous with \fB&\fP,
\fB|\fP, \fB&!\fP and \fB^\fP respectively.
.SH EXAMPLES
.TP
.B dejasearch linux ip masquerading ppp
This will search for all messages containing "linux", "ip", "masquerading"
and "ppp" and output all messages to "summary.html".
.TP
.B dejasearch """linux [ip masquerading] ppp"""
This will search for all messages containing "linux", "ip masquerading"
and "ppp" and output all messages to "summary.html". Since I don't know
of any method to pass double quotes to the shell (I use tcsh), I chose
\fB[\fP and \fB]\fP as an alias for specifying a phrase.
.TP
.B dejasearch """linux & (ip ^ masquerading) & ppp"""
This will search for all messages containing "linux", "ip" and "masquerading"
close to one another and "ppp" and output all messages to "summary.html".
.TP
.B
dejasearch -max 50 -output results.html linux ip masquerading ppp
This will search for up to 50 messages containing "linux", "ip", "masquerading"
and "ppp" and output all messages to "results.html".
.SH FILES
.TP
.B ~/.dejasearchrc
Proxy authentication information, in "\fIusername\fP\fB:\fP\fIpassword\fP"
format (on a single line and without the quotes). The mode of this file must be
400 or 600, or DejaSearch aborts with a non-zero status.
.SH ENVIRONMENT
.TP
.B http_proxy
HTTP proxy to use, in "\fBhttp://\fP\fIhostname\fP\fB:\fP\fIport\fP" format
(without the quotes).
.SH "EXIT STATUS"
.ta 5
\fB0\fP OK.
.br
\fB255\fP An error occurred.
.SH BUGS
See \fBREADME\fP.
.SH AUTHOR
Chew Wei Yih, Victor <vchew@post1.com>
.br
Steffen Ullrich <coyote.frank@gmx.net>
.br
Frank de Lange <frank@unternet.org>
.br
J.R. Tietsort <jrtietsort@micron.com>
.PP
Contributor:
Andr Majorel <amajorel@teaser.fr>
.PP
Homepage: http://homemade.hypermart.net/dejasearch/
|