aboutsummaryrefslogtreecommitdiff
path: root/development/bascat/bascat.rst
blob: f0f089319e6705f2d3d1edf20636f9faea38079d (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
.. RST source for bascat(1) man page. Convert with:
..   rst2man.py bascat.rst > bascat.1
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 1.2pre2
.. |date| date::

======
bascat
======

----------------------------------------
detokenizer for BBC Micro BASIC programs
----------------------------------------

:Manual section: 1
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

**bascat** [*--help* | *-h*] [*--version* | *-v*] [*--line-numbers* | *-n*] [*--no-line-numbers* | *+n*] [*--highlight* | *-l* ] [*--no-highlight* | *+l* ] [*--pager=PAGER* | *-p PAGER*] [*file* ...]

DESCRIPTION
===========

Types tokenized (SAVEd) BBC BASIC programs in a readable way.

With no *file* arguments, **bascat** reads from standard input.

If standard output is a terminal, output will be piped through a
pager. The default is **$PAGER** from the environment, or **less** if
not set. Note that if standard output is not a terminal (e.g. if redirecting to
a file), no pager is used.

Options can be placed in the **BASCAT** environment variable, if you don't
like the standard settings.

OPTIONS
=======

Prefix long options with **no-** to cancel them.  Use **+** to cancel short options.

--help, -h
  Display built-in help message and exit.

--version, -h
  Display version number and exit.

--line-numbers, -n
  Display line numbers for each line. This is enabled by default; use **+n** or
  **--no-line-numbers** to disable.

--highlight, -l
  Attempts to highlight keywords. Whether this works properly or not depends on
  the pager in use; **more**\(1), **less**\(1), and **most**\(1) work correctly.
  **lv**\(1) will work if you have **-c** in **~/.lv** or **LV** in the environment.

--pager=pager, -p pager
  Sets pager to use, if standard output is a terminal. Overrides **PAGER** environment variable.
  If you don't want a pager, use **-p cat**.

.. FILES
.. =====

.. ENVIRONMENT
.. ===========

.. EXIT STATUS
.. ===========

.. BUGS
.. ====

.. EXAMPLES
.. ========

COPYRIGHT
=========

See the file /usr/doc/bascat-|version|/README for license information.

AUTHORS
=======

**bascat** was written by Matthew Wilcox and Mark Wooding.

This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.

SEE ALSO
========

**dfsimage**\(1)

The bascat homepage: https://git.distorted.org.uk/~mdw/