diff options
author | wiz <wiz@pkgsrc.org> | 2001-12-03 19:03:19 +0000 |
---|---|---|
committer | wiz <wiz@pkgsrc.org> | 2001-12-03 19:03:19 +0000 |
commit | b4f0a668fa0041bdd4f700917762a64854abd442 (patch) | |
tree | b1dba1934d8e474a3e6946d57aef51d6abcb1540 /devel/bcc | |
parent | bf1895f0b4ea7e92a31395a74170ce7fad30b048 (diff) | |
download | pkgsrc-b4f0a668fa0041bdd4f700917762a64854abd442.tar.gz |
Miscellaneous man page fixes.
Diffstat (limited to 'devel/bcc')
-rw-r--r-- | devel/bcc/files/as86.1 | 52 | ||||
-rw-r--r-- | devel/bcc/files/bcc-cc1.1 | 40 | ||||
-rw-r--r-- | devel/bcc/files/bcc.1 | 67 | ||||
-rw-r--r-- | devel/bcc/files/ld86.1 | 41 |
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. - |