File: dejasearch.1

package info (click to toggle)
dejasearch 1.8.4-1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 140 kB
  • ctags: 21
  • sloc: perl: 773; makefile: 49
file content (158 lines) | stat: -rw-r--r-- 4,626 bytes parent folder | download
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/