summaryrefslogtreecommitdiff
path: root/devel/bcc
diff options
context:
space:
mode:
authorwiz <wiz>2001-12-03 19:03:19 +0000
committerwiz <wiz>2001-12-03 19:03:19 +0000
commit99685bbac670f3e20cda1116d2d0a05f48d831bc (patch)
treeb1dba1934d8e474a3e6946d57aef51d6abcb1540 /devel/bcc
parent7b1ab1085283a4465275bf432a55f020306b2357 (diff)
downloadpkgsrc-99685bbac670f3e20cda1116d2d0a05f48d831bc.tar.gz
Miscellaneous man page fixes.
Diffstat (limited to 'devel/bcc')
-rw-r--r--devel/bcc/files/as86.152
-rw-r--r--devel/bcc/files/bcc-cc1.140
-rw-r--r--devel/bcc/files/bcc.167
-rw-r--r--devel/bcc/files/ld86.141
4 files changed, 28 insertions, 172 deletions
diff --git a/devel/bcc/files/as86.1 b/devel/bcc/files/as86.1
index ab795837d6e..ff449309739 100644
--- a/devel/bcc/files/as86.1
+++ b/devel/bcc/files/as86.1
@@ -1,4 +1,4 @@
-.\" $NetBSD: as86.1,v 1.2 1998/08/07 10:40:20 agc Exp $
+.\" $NetBSD: as86.1,v 1.3 2001/12/03 19:03:21 wiz Exp $
.\"
.\" This manual page has been assembled after Bruce's original bcc.doc
.\" file by Jörg Wunsch <joerg@FreeBSD.org>.
@@ -21,111 +21,78 @@
.Op Fl s Ar sym
.Ar src
.Sh DESCRIPTION
-
.Ss Overview
.Nm As86
is an assembler for 8086 or 80386 CPUs. Its syntax resembles rather
the usual 8086 assembler syntax than the AT&T-like syntax as used by
the system's assembler
.Xr as 1 .
-
+.Pp
It can also be compiled to support the Motorola 6809 CPU. The name
.Nm as86
has only been chosen to make it distinct from the system's assembler.
-
.Ss Options
-
.Bl -tag -width indent -compact
-
.It Fl 0
.Pq the digit 0
start with 16-bit code segment
-
.It Fl 3
start with 32-bit code segment
-
.It Fl a
enable partial compatibility with asld
-
.It Fl b
produce binary file, filename may follow
.Pq obsolete
-
.It Fl g
only put global symbols in object file
-
.It Fl j
force all jumps to be long
-
.It Fl l
produce list file, filename may follow
-
.It Fl m
print macro expansions in listing
-
.It Fl n
name of module follows
.Pq goes in object instead of source name
-
.It Fl o
produce object file, filename follows
-
.It Fl s
produce symbol file, filename follows
.Pq obsolete
-
.It Fl u
take undefined symbols as imported-with-unspecified segment
-
.It Fl w
don't print warnings
-
.El
-
+.Pp
The 6809 version does not support
.Fl 0 ,
.Fl 3 ,
.Fl a
or
.Fl j .
-
-
.Ss Defaults
Off or none except for these; no output is produced without a flag:
-
.Bl -tag -width indenct -compact
-
.It Fl 0 | Fl 3
native, i.\& e. 80386
-
.It Ar list
stdout
.Pq beware of clobbering next arg
-
.It Ar name
basename of the source name
-
.El
-
.Ss Input syntax
-
The following lists all acceptable names except the CPU instructions:
-
.Bl -tag -width "XXXXXXX" -compact -offset indent
-
.It Register names
-
bp, bx, di, si, eax, ebp, ecx, edi, edx, esi, esp,
ax, cx, dx, sp, ah, al, bh, bl, ch, cl, dh, dl,
cs, ds, es, fs, gs, ss, cr0, cr2, cr3, dr0, dr1,
dr3, dr6, dr7, tr3, tr4, tr5, tr6, tr7, st.
-
.It Type sizes
-
byte, dword, fword, far, ptr, pword, qword, tbyte, word.
-
.It Pseudo-operations
-
else, elseif, elseifc, endif, if, ifc;
\&.align, .ascii, .blkb, .blkw, block, .bss, .byte, comm, .comm,
\&.data, .data1, .data2, .data4, db, dd, .define, dw, end, endb,
@@ -134,20 +101,14 @@ fcb, fcc, fdb, get, .globl, ident, import, include, lcomm, .lcomm,
\&.list, loc, .long, .maclist, macro, .map, org, .org, public,
rmb, .rom, .sect, set, setdp, .short, .space, .text, use16,
use32, .warn, .word, .zero.
-
.El
.Sh SEE ALSO
-
-.Xr as 1 ;
-.Xr ld86 1 ,
-.Xr bcc 1 .
-
+.Xr as 1 ,
+.Xr bcc 1 ,
+.Xr ld86 1
.Sh AUTHORS
-
This program has been developed by Bruce Evans.
-
.Sh BUGS
-
The
.Fl u
and
@@ -156,4 +117,3 @@ options are perhaps back to front because they are needed for cc1
output and Minix's make does the wrong thing with .s files left
around. However, all assembler code not written by compilers should
assemble with them turned off.
-
diff --git a/devel/bcc/files/bcc-cc1.1 b/devel/bcc/files/bcc-cc1.1
index 99757b7e8e1..6a44f4edde5 100644
--- a/devel/bcc/files/bcc-cc1.1
+++ b/devel/bcc/files/bcc-cc1.1
@@ -1,4 +1,4 @@
-.\" $NetBSD: bcc-cc1.1,v 1.2 1998/08/07 10:40:20 agc Exp $
+.\" $NetBSD: bcc-cc1.1,v 1.3 2001/12/03 19:03:21 wiz Exp $
.\"
.\" This manual page has been assembled after Bruce's original bcc.doc
.\" file by Jörg Wunsch <joerg@FreeBSD.org>.
@@ -19,68 +19,50 @@
.Op Fl U Ns Ar undef
.Op Fl o Ar outfile
.Op Ar infile
-
.Sh DESCRIPTION
-
.Nm Bcc-cc1
is the backend for the
.Xr bcc 1
C compiler.
-
+.Pp
It understands the following options:
-
.Bl -tag -width indent -compact
-
.It Fl 0
.Pq the digit 0
8086 target
.Pq works even on 80386 host
-
.It Fl 3
80386 target
.Pq works even on 8086 host
-
.It Fl D
define
-
.It Fl E
produce preprocessor output
-
.It Fl I
include search path
-
.It Fl P
produce preprocessor output with no line numbers
-
.It Fl c
produce code with caller saving regs before function calls
-
.It Fl d
print debugging information in assembly output
-
.It Fl f
produce code with 1st argument passed in a register
-
.It Fl l
produce code for 2 3 1 0 long byte order
.Pq only works in 16-bit versions
-
.It Fl o
assembler output file name follows
-
.It Fl p
produce
.Pq almost
position-independent code
-
.It Fl t
print source code in assembly output
-
.It Fl w
print what cc1 thinks is the location counter in assembly output
-
.El
-
+.Pp
All the options except
.Fl D ,
.Fl I
@@ -90,15 +72,13 @@ may be turned off by following the
option letter by a
.Sq - .
Options are processed left to right so the last setting has precedence.
-
+.Pp
The following is defined before option processing:
-
.Bd -literal
__BCC__ 1
.Ed
-
+.Pp
The following may be defined after option processing:
-
.Bd -literal
__AS09__ 1 if 6809 version
__AS386_16__ 1 if -0 option on 80*86
@@ -109,21 +89,15 @@ __FIRST_ARG_IN_X__ 1 if -f option on 6809
__LONG_BIG_ENDIAN__ 1 if -l option
__POS_INDEPENDENT__ 1 if -p option on 6809
.Ed
-
+.Pp
The following are standard builtins:
-
.Bd
__FILE__ stringized name of current input file
__LINE__ current line number
.Ed
-
.Sh FILES
.Pa /usr/local/lib/bcc/bcc-cc1
-
.Sh SEE ALSO
-
-.Xr bcc 1 .
-
+.Xr bcc 1
.Sh AUTHORS
-
This program has been written by Bruce Evans.
diff --git a/devel/bcc/files/bcc.1 b/devel/bcc/files/bcc.1
index 80a0c56671d..5b2d7acf466 100644
--- a/devel/bcc/files/bcc.1
+++ b/devel/bcc/files/bcc.1
@@ -1,4 +1,4 @@
-.\" $NetBSD: bcc.1,v 1.2 1998/08/07 10:40:20 agc Exp $
+.\" $NetBSD: bcc.1,v 1.3 2001/12/03 19:03:21 wiz Exp $
.\"
.\" This manual page has been assembled after Bruce's original bcc.doc
.\" file by Jörg Wunsch <joerg@FreeBSD.org>.
@@ -27,11 +27,8 @@
.Op Fl fpt Ar error
.Op ld_options
.Op Ar infiles
-
.Sh DESCRIPTION
-
.Ss Overview
-
.Nm Bcc
is a simple C compiler suitable for generating 8086 or 80386 code.
It basically understands the old K&R C input syntax, with some
@@ -39,29 +36,23 @@ restrictions on bit fields. It interacts with the programs
.Xr as86 1
and
.Xr ld86 1 .
-
+.Pp
As a compile-time option, it is also possible to convince
.Nm bcc
to generate code for the Motorola 6809 CPU.
-
.Ss Options
-
.Bl -tag -width indent -compact
-
.It Fl 0
.Pq the digit 0
8086 target
.Pq works even on 80386 host
-
.It Fl 3
80386 target
.Pq works even on 8086 host
-
.It Fl A
pass remainder of option to assembler; e.\& g.
.Ql -A-l -Alistfile
for a listing
-
.It Fl B
prefix for executable search path; the search order is all paths
specified using
@@ -71,42 +62,31 @@ in order, then the path given in the environment variable
if that is set, then the compiled-in defaults
.Pa /usr/local/lib/bcc ,
followed by
-.Pa /usr/local/bin
-
+.Pa /usr/local/bin
.It Fl C
pass remainder of option to bcc-cc1; e.\& g.
.Ql -C-c
for caller-saves
-
.It Fl D
define
-
.It Fl E
produce preprocessor output
-
.It Fl G
produce gnu-Minix objects
.Pq link with gnu ld
-
.It Fl I
include search path
-
.It Fl L
pass remainder of option to linker
-
.It Fl O
optimize
.Pq does nothing
-
.It Fl P
produce preprocessor output with no line numbers
-
.It Fl Q
pass full option to c386
-
.It Fl S
produce assembler file
-
.It Fl T
temporary directory;
overrides previous value and default; default is
@@ -114,43 +94,33 @@ from the environment variable
.Ev TMPDIR
if that is set, otherwise
.Pa /tmp
-
.It Fl U
undefine
-
.It Fl V
print names of files being compiled
-
.It Fl c
produce object file
-
.It Fl e
run the preprocess pass separately. This takes less memory, and may
help or harm by giving more traditional semantics like token pasting
with
.Ql /**/
\&.
-
.It Fl f
error
.Pq float emulation not supported
-
.It Fl g
produce debugging info
.Pq does nothing
-
.It Fl o
-output file name follows
+output file name follows
.Pq assembler, object or executable
-
.It Fl p
error
.Pq profiling not supported
-
.It Fl t
error
.Pq substitution of some cc passes not supported
-
.It Fl v
print names and args of subprocesses being run.
.Pp
@@ -161,26 +131,21 @@ Two or more
Three or more
.Fl v
\&'s: print names of paths being searched.
-
.El
-
+.Pp
The 6809 version does not support
.Fl 0 ,
.Fl 3
or
-.Fl G.
-
+.Fl G .
+.Pp
Only the c386 version supports
.Fl Q .
-
.Ss Defaults
Off or none except for these:
-
.Bl -tag -width indent -compact
-
.It Fl 0 | Fl 3
native, i.\& e. 80386
-
.It Ar outfile
stdout for preprocessor output
.Pp
@@ -196,9 +161,8 @@ for assembler output
.Pp
.Pa a.out
for ld output
-
.El
-
+.Pp
Other options are passed to the linker, in particular
.Fl i- ,
.Fl l Ns Ar x ,
@@ -209,26 +173,17 @@ The
.Fl i
option is always passed to the linker but can be cancelled using
.Fl i- .
-
.Sh ENVIRONMENT
-
.Bl -tag -width indent -compact
-
.It Ev BCC_EXEC_PREFIX
directory to search for compiler passes
-
.It Ev TMPDIR
where to place temporary files
-
.El
-
.Sh SEE ALSO
-
.Xr as86 1 ,
-.Xr ld86 1 ,
-.Xr bcc-cc1 1 ;
-.Xr cc 1 .
-
+.Xr bcc-cc1 1 ,
+.Xr cc 1 ,
+.Xr ld86 1
.Sh AUTHORS
-
This program has been written by Bruce Evans.
diff --git a/devel/bcc/files/ld86.1 b/devel/bcc/files/ld86.1
index 4176c4dd3e7..cb4e9245929 100644
--- a/devel/bcc/files/ld86.1
+++ b/devel/bcc/files/ld86.1
@@ -1,4 +1,4 @@
-.\" $NetBSD: ld86.1,v 1.2 1998/08/07 10:40:20 agc Exp $
+.\" $NetBSD: ld86.1,v 1.3 2001/12/03 19:03:21 wiz Exp $
.\"
.\" This manual page has been assembled after Bruce's original bcc.doc
.\" file by Jörg Wunsch <joerg@FreeBSD.org>.
@@ -23,117 +23,84 @@
.Ar infile
.Op Ar ...
.Sh DESCRIPTION
-
.Ss Overview
-
.Nm Ld86
is the loader that understands how to link the output of
.Xr as86 1
together.
-
.Ss Options
-
.Bl -tag -width indent -compact
-
.It Fl 0
.Pq the digit 0
produce header with 16-bit magic and use library subdir
.Pa i86
for
.Fl l Ns Ar x
-
.It Fl 3
produce header with 32-bit magic and use library subdir
.Pa i386
for
.Fl l Ns Ar x
-
.It Fl C Ns Ar x
add file
.Pa libdir-from-search/crt Ns Ar x Ns \&.o
to list of files linked
-
.It Fl L Ns Ar x
add dir name
.Ar x
to the head of the list of library dirs searched
-
.It Fl M
print symbols linked on stdout
-
.It Fl O Ns Ar x
add library
.Pa libdir-from-search/ Ns Ar x
to list of files linked
-
.It Fl T
text base address follows
.Pq in format suitable for strtoul
-
.It Fl i
separate I&D output
-
.It Fl l Ns Ar x
add library
.Pa libdir-from-search/lib Ns Ar x Ns \&.a
to list of files linked
-
.It Fl m
print modules linked on stdout
-
.It Fl o
output file name follows
-
.It Fl r
produce output suitable for further relocation
-
.It Fl s
strip symbols
-
.It Fl t
trace modules being looked at on stdout
-
.It Fl z
produce
.Dq unmapped zero page
executables
-
-
.El
-
+.Pp
The 6809 version does not support -i or -r.
-
+.Pp
All the options not taking an argument may be turned off by following the
option letter by a
.Sq \&- ,
as for bcc-cc1.
-
.Ss Defaults
-
Off or none except for these:
-
.Bl -tag -width indent -compact
-
.It Fl 0 | Fl 3
native, i.\& e. 80386
-
.It Fl L Ns Pa /usr/local/lib/bcc/ Ns Ar m/
.Po
.Ar m
is machine dependent
.Pc
-
.It Ar outfile
.Pa a.out
-
.El
-
.Sh SEE ALSO
-
.Xr as86 1 ,
-.Xr bcc 1 .
-
+.Xr bcc 1
.Sh AUTHORS
-
This programm has been written by Bruce Evans.
-