summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRalf Baechle <ralf@linux-mips.org>2011-12-11 17:32:51 +0000
committerRalf Baechle <ralf@linux-mips.org>2011-12-11 17:32:51 +0000
commit4e1929b059c8249870e628cc4dae129cd5e18ec9 (patch)
treeb38ce38e6453748315dfdeeb384d6861392c8381
parentb9ac7b273b84f78355517ad6098d6359b68dab1c (diff)
Apply program name transformations also to man page content.
For now these options are just honored for the call.1 and listen.1 man pages because these days these two programs generally get renamed to avoid naming conflicts with other programs.
-rw-r--r--call/Makefile.am17
-rw-r--r--call/call.man (renamed from call/call.1)26
-rw-r--r--listen/Makefile.am19
-rw-r--r--listen/listen.man (renamed from listen/listen.1)16
4 files changed, 56 insertions, 22 deletions
diff --git a/call/Makefile.am b/call/Makefile.am
index 9668863..70df548 100644
--- a/call/Makefile.am
+++ b/call/Makefile.am
@@ -8,9 +8,26 @@ installconf:
bin_PROGRAMS = call
man_MANS = call.1
+CLEANFILES = call.1 call.1.tmp
EXTRA_DIST = $(man_MANS)
+call.1 : call.man
+ name_call=$$(echo call | sed -e '$(transform)') \
+ name_Call=$$(echo $$name_call | sed -r 's@^(.)@\U\1\E@') && \
+ name_CALL=$$(echo $$name_call | sed -r 's@^(.*)@\U\1\E@') && \
+ name_listen=$$(echo listen | sed -e '$(transform)') \
+ name_Listen=$$(echo $$name_listen | sed -r 's@^(.)@\U\1\E@') && \
+ name_LISTEN=$$(echo $$name_listen | sed -r 's@^(.*)@\U\1\E@') &&\
+ sed -e "s/@@@call@@@/$$name_call/g" \
+ -e "s/@@@Call@@@/$$name_Call/g" \
+ -e "s/@@@CALL@@@/$$name_CALL/g" \
+ -e "s/@@@listen@@@/$$name_listen/g" \
+ -e "s/@@@Listen@@@/$$name_Listen/g" \
+ -e "s/@@@LISTEN@@@/$$name_LISTEN/g" \
+ call.man > call.1.tmp && \
+ mv call.1.tmp call.1;
+
call_LDADD = $(NCURSES_LIB) $(AX25_LIB)
call_SOURCES = \
diff --git a/call/call.1 b/call/call.man
index e4236b8..85c291b 100644
--- a/call/call.1
+++ b/call/call.man
@@ -1,22 +1,22 @@
-.TH CALL 1 "27 August 1996" Linux "Linux Programmer's Manual"
+.TH @@@CALL@@@ 1 "27 August 1996" Linux "Linux Programmer's Manual"
.SH NAME
-call \- make an AX.25, NET/ROM or Rose connection.
+@@@call@@@ \- make an AX.25, NET/ROM or Rose connection.
.SH SYNOPSIS
For AX.25
.br
-.B call [-b l|e] [-d] [-h] [-m s|e] [-p paclen] [-s mycall] [-r] [-t] [-T timeout] [-v] [-w window] [-W] port callsign [[via] digipeaters.....]
+.B @@@call@@@ [-b l|e] [-d] [-h] [-m s|e] [-p paclen] [-s mycall] [-r] [-t] [-T timeout] [-v] [-w window] [-W] port callsign [[via] digipeaters.....]
.sp 1
For NET/ROM
.br
-.B call [-d] [-h] [-p paclen] [-r] [-t] [-v] port callsign
+.B @@@call@@@ [-d] [-h] [-p paclen] [-r] [-t] [-v] port callsign
.sp 1
For Rose
.br
-.B call [-d] [-h] [-r] [-t] [-v] port callsign address [[via] digipeater]
+.B @@@call@@@ [-d] [-h] [-r] [-t] [-v] port callsign address [[via] digipeater]
.br
.SH DESCRIPTION
.LP
-.B Call
+.B @@@Call@@@
is the general purpose AX.25, NET/ROM and Rose connection program. As is normal
in AX.25 it runs entirely in line mode. All CR/LF translation is done
transparently. The program provides ASCII, YAPP, YAPP-C and 7+ file
@@ -25,12 +25,12 @@ the program will quietly ignore them if given in NET/ROM mode or in Rose
mode.
.LP
This version of
-.B call
+.B @@@call@@@
incorporates many changes that include a much improved user interface. The
port name is mandatory and is the name of the port which the connection will
be made on. The port name may be either an AX.25, a NET/ROM port or a Rose
port,
-.B call
+.B @@@call@@@
will determine which automatically.
.LP
When using NET/ROM the use of digipeaters is meaningless and is not
@@ -69,14 +69,14 @@ for extended (modulus 128) AX.25 operation.
Specify a specific maximum amount of data to be sent in each AX.25 packet.
.TP 10
.BI "\-s mycall"
-Connect using the specified source call (you may need to be root).
+Connect using the specified source @@@call@@@ (you may need to be root).
.TP 10
.BI \-R
Disable all remote commands like autobin (#BIN#), 7plus downloads, //echo, etc.
This is useful for scripting where you just don't like the remote site to trigger uncaught conditions here.
.TP 10
.BI \-S
-Be silent. Useful for using call in shellscripts (together with option \-r) in order to be really transparent.
+Be silent. Useful for using @@@call@@@ in shellscripts (together with option \-r) in order to be really transparent.
.TP 10
.BI "\-T timeout"
Set idle timeout seconds after a connection will be closed automaticaly when there's no data being transferred (in- and outbound). If timeout is set to 3600, the connection will close after 1h inactivity. A value of 0.5 is 500ms.
@@ -94,9 +94,9 @@ Display the version.
Specify a specific AX.25 window for this connection. Only valid in AX.25 mode.
.TP 10
.BI "\-W"
-Wait for remote disconnect even if stdin is closed. Normaly, "echo q | call ax0 db0fhn" closes immediately after "echo q" terminates; thus we never see the greeting from db0fhn. With the -W option, call waits until the ax25-connection is disconnected (i.e. db0fhn disconnects after "q" command). Very useful for scripting. You might like to combine it with the -T option.
+Wait for remote disconnect even if stdin is closed. Normaly, "echo q | @@@call@@@ ax0 db0fhn" closes immediately after "echo q" terminates; thus we never see the greeting from db0fhn. With the -W option, @@@call@@@ waits until the ax25-connection is disconnected (i.e. db0fhn disconnects after "q" command). Very useful for scripting. You might like to combine it with the -T option.
.LP
-The call program interprets lines beginning with a '~' specially.
+The @@@call@@@ program interprets lines beginning with a '~' specially.
The following '~' escapes are available.
.TP 16
.BI ~?
@@ -169,7 +169,7 @@ however '8 bit clean'.
/etc/ax25/rsports
.fi
.SH "SEE ALSO"
-.BR listen (1),
+.BR @@@listen@@@ (1),
.BR mheard (1),
.BR ax25 (4),
.BR netrom (4),
diff --git a/listen/Makefile.am b/listen/Makefile.am
index b47ecde..55a937c 100644
--- a/listen/Makefile.am
+++ b/listen/Makefile.am
@@ -5,7 +5,24 @@ bin_PROGRAMS = listen
man_MANS = listen.1
-EXTRA_DIST = $(man_MANS)
+EXTRA_DIST = listen.man
+CLEANFILES = listen.1 listen.1.tmp
+
+listen.1 : listen.man
+ name_call=$$(echo call | sed -e '$(transform)') \
+ name_Call=$$(echo $$name_call | sed -r 's@^(.)@\U\1\E@') && \
+ name_CALL=$$(echo $$name_call | sed -r 's@^(.*)@\U\1\E@') && \
+ name_listen=$$(echo listen | sed -e '$(transform)') \
+ name_Listen=$$(echo $$name_listen | sed -r 's@^(.)@\U\1\E@') && \
+ name_LISTEN=$$(echo $$name_listen | sed -r 's@^(.*)@\U\1\E@') &&\
+ sed -e "s/@@@call@@@/$$name_call/g" \
+ -e "s/@@@Call@@@/$$name_Call/g" \
+ -e "s/@@@CALL@@@/$$name_CALL/g" \
+ -e "s/@@@listen@@@/$$name_listen/g" \
+ -e "s/@@@Listen@@@/$$name_Listen/g" \
+ -e "s/@@@LISTEN@@@/$$name_LISTEN/g" \
+ listen.man > listen.1.tmp && \
+ mv listen.1.tmp listen.1;
LDADD = $(AX25_LIB) $(NCURSES_LIB)
diff --git a/listen/listen.1 b/listen/listen.man
index 030b716..adc8dea 100644
--- a/listen/listen.1
+++ b/listen/listen.man
@@ -1,11 +1,11 @@
-.TH LISTEN 1 "27 August 1996" Linux "Linux Programmer's Manual"
+.TH @@@LISTEN@@@ 1 "27 August 1996" Linux "Linux Programmer's Manual"
.SH NAME
-listen \- monitor AX.25 traffic
+@@@listen@@@ \- monitor AX.25 traffic
.SH SYNOPSIS
-.B listen [-8] [-a] [-c] [-h] [-i] [-p port] [-r] [-t] [-v]
+.B @@@listen@@@ [-8] [-a] [-c] [-h] [-i] [-p port] [-r] [-t] [-v]
.SH DESCRIPTION
.LP
-.B Listen
+.B @@@Listen@@@
uses SOCK_PACKET facilities to provide a network monitor of all AX.25
traffic heard by the system. Since KISS is implicitly promiscuous no
special driver configurations are needed.
@@ -15,12 +15,12 @@ IP, ICMP, TCP and UDP. It also displays IP, TCP, ICMP, TCP and UDP
encapsulated within NET/ROM frames. The program also displays AX.25 and IP
encapsulated within an IP frame, but see RFC1326 for reasons not to do so.
.LP
-.B Listen
+.B @@@Listen@@@
makes an attempt at decoding some of the more common routing protocols. RSPF
and RIP (both \(lqnormal\(rq and G8BPQs RIP98) are traced. JNOS style
NET/ROM node polls are also displayed.
.LP
-.B Listen
+.B @@@Listen@@@
can use colors to make the output more readable. The ncurses library is used
to accomplish this.
.B Color support defaults to being disabled,
@@ -64,7 +64,7 @@ Display the version.
.SH FILES
/etc/ax25/axports
.SH "SEE ALSO"
-.BR call (1),
+.BR @@@call@@@ (1),
.BR mheard (1),
.BR beacon (1),
.BR ax25 (4),
@@ -73,7 +73,7 @@ Display the version.
.BR kissattach (8).
.LP
.SH BUGS
-.B Listen
+.B @@@Listen@@@
does not validate the checksums of frames that support them (ie IP),
therefore corrupt frames will be displayed with bogus values. The MSS
of a TCP frame that contains that option is not displayed.