aboutsummaryrefslogtreecommitdiff
path: root/development/bascat/bascat.1
blob: 0d7fedd62d243746ca3f7d4f75df176400d01715 (plain)
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
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "BASCAT" 1 "2023-05-05" "1.2pre2" "SlackBuilds.org"
.SH NAME
bascat \- detokenizer for BBC Micro BASIC programs
.\" RST source for bascat(1) man page. Convert with:
.
.\" rst2man.py bascat.rst > bascat.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
\fBbascat\fP [\fI\-\-help\fP | \fI\-h\fP] [\fI\-\-version\fP | \fI\-v\fP] [\fI\-\-line\-numbers\fP | \fI\-n\fP] [\fI\-\-no\-line\-numbers\fP | \fI+n\fP] [\fI\-\-highlight\fP | \fI\-l\fP ] [\fI\-\-no\-highlight\fP | \fI+l\fP ] [\fI\-\-pager=PAGER\fP | \fI\-p PAGER\fP] [\fIfile\fP ...]
.SH DESCRIPTION
.sp
Types tokenized (SAVEd) BBC BASIC programs in a readable way.
.sp
With no \fIfile\fP arguments, \fBbascat\fP reads from standard input.
.sp
If standard output is a terminal, output will be piped through a
pager. The default is \fB$PAGER\fP from the environment, or \fBless\fP if
not set. Note that if standard output is not a terminal (e.g. if redirecting to
a file), no pager is used.
.sp
Options can be placed in the \fBBASCAT\fP environment variable, if you don\(aqt
like the standard settings.
.SH OPTIONS
.sp
Prefix long options with \fBno\-\fP to cancel them.  Use \fB+\fP to cancel short options.
.INDENT 0.0
.TP
.B  \-\-help\fP,\fB  \-h
Display built\-in help message and exit.
.TP
.B  \-\-version\fP,\fB  \-h
Display version number and exit.
.TP
.B  \-\-line\-numbers\fP,\fB  \-n
Display line numbers for each line. This is enabled by default; use \fB+n\fP or
\fB\-\-no\-line\-numbers\fP to disable.
.TP
.B  \-\-highlight\fP,\fB  \-l
Attempts to highlight keywords. Whether this works properly or not depends on
the pager in use; \fBmore\fP(1), \fBless\fP(1), and \fBmost\fP(1) work correctly.
\fBlv\fP(1) will work if you have \fB\-c\fP in \fB~/.lv\fP or \fBLV\fP in the environment.
.TP
.BI \-\-pager\fB= pager\fR,\fB \ \-p \ pager
Sets pager to use, if standard output is a terminal. Overrides \fBPAGER\fP environment variable.
If you don\(aqt want a pager, use \fB\-p cat\fP\&.
.UNINDENT
.\" FILES
.
.\" =====
.
.\" ENVIRONMENT
.
.\" ===========
.
.\" EXIT STATUS
.
.\" ===========
.
.\" BUGS
.
.\" ====
.
.\" EXAMPLES
.
.\" ========
.
.SH COPYRIGHT
.sp
See the file /usr/doc/bascat\-1.2pre2/README for license information.
.SH AUTHORS
.sp
\fBbascat\fP was written by Matthew Wilcox and Mark Wooding.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
\fBdfsimage\fP(1)
.sp
The bascat homepage: \fI\%https://git.distorted.org.uk/~mdw/\fP
.\" Generated by docutils manpage writer.
.