| Index: third_party/yasm/patched-yasm/yasm_objfmts.7
|
| ===================================================================
|
| --- third_party/yasm/patched-yasm/yasm_objfmts.7 (revision 165590)
|
| +++ third_party/yasm/patched-yasm/yasm_objfmts.7 (working copy)
|
| @@ -1,81 +1,91 @@
|
| +'\" t
|
| .\" Title: yasm_objfmts
|
| .\" Author: Peter Johnson <peter@tortall.net>
|
| -.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
|
| +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
| .\" Date: February 2007
|
| .\" Manual: Yasm Supported Object Formats
|
| .\" Source: Yasm
|
| +.\" Language: English
|
| .\"
|
| .TH "YASM_OBJFMTS" "7" "February 2007" "Yasm" "Yasm Supported Object Formats"
|
| +.\" -----------------------------------------------------------------
|
| +.\" * set default formatting
|
| +.\" -----------------------------------------------------------------
|
| .\" disable hyphenation
|
| .nh
|
| .\" disable justification (adjust text to left margin only)
|
| .ad l
|
| +.\" -----------------------------------------------------------------
|
| +.\" * MAIN CONTENT STARTS HERE *
|
| +.\" -----------------------------------------------------------------
|
| .SH "NAME"
|
| yasm_objfmts \- Yasm Supported Object Formats
|
| .SH "SYNOPSIS"
|
| -.HP 5
|
| -\fByasm\fR \fB\-f\ \fR\fB\fIobjfmt\fR\fR \fB\fI...\fR\fR
|
| +.HP \w'\fByasm\fR\ 'u
|
| +\fByasm\fR \fB\-f\ \fR\fB\fIobjfmt\fR\fR \fB\fI\&.\&.\&.\fR\fR
|
| .SH "DESCRIPTION"
|
| .PP
|
| -The standard Yasm distribution includes a number of modules for different object formats (Yasm's primary output).
|
| +The standard Yasm distribution includes a number of modules for different object formats (Yasm\'s primary output)\&.
|
| .PP
|
| The object format is selected on the
|
| \fByasm\fR(1)
|
| command line by use of the
|
| \fB\-f \fR\fB\fIobjfmt\fR\fR
|
| -command line option.
|
| +command line option\&.
|
| .SH "BIN"
|
| .PP
|
| The
|
| \(lqbin\(rq
|
| -object format produces a flat\-format, non\-relocatable binary file. It is appropriate for producing DOS .COM executables or things like boot blocks. It supports only 3 sections and those sections are written in a predefined order to the output file.
|
| +object format produces a flat\-format, non\-relocatable binary file\&. It is appropriate for producing DOS \&.COM executables or things like boot blocks\&. It supports only 3 sections and those sections are written in a predefined order to the output file\&.
|
| .SH "COFF"
|
| .PP
|
| -The COFF object format is an older relocatable object format used on older Unix and compatible systems, and also (more recently) on the DJGPP development system for DOS.
|
| +The COFF object format is an older relocatable object format used on older Unix and compatible systems, and also (more recently) on the DJGPP development system for DOS\&.
|
| .SH "DBG"
|
| .PP
|
| The
|
| \(lqdbg\(rq
|
| object format is not a
|
| \(lqreal\(rq
|
| -object format; the output file it creates simply describes the sequence of calls made to it by Yasm and the final object and symbol table information in a human\-readable text format (that in a normal object format would get processed into that object format's particular binary representation). This object format is not intended for real use, but rather for debugging Yasm's internals.
|
| +object format; the output file it creates simply describes the sequence of calls made to it by Yasm and the final object and symbol table information in a human\-readable text format (that in a normal object format would get processed into that object format\'s particular binary representation)\&. This object format is not intended for real use, but rather for debugging Yasm\'s internals\&.
|
| .SH "ELF"
|
| .PP
|
| The ELF object format really comes in two flavors:
|
| \(lqelf32\(rq
|
| (for 32\-bit targets) and
|
| \(lqelf64\(rq
|
| -(for 64\-bit targets). ELF is a standard object format in common use on modern Unix and compatible systems (e.g. Linux, FreeBSD). ELF has complex support for relocatable and shared objects.
|
| +(for 64\-bit targets)\&. ELF is a standard object format in common use on modern Unix and compatible systems (e\&.g\&. Linux, FreeBSD)\&. ELF has complex support for relocatable and shared objects\&.
|
| .SH "MACHO"
|
| .PP
|
| The Mach\-O object format really comes in two flavors:
|
| \(lqmacho32\(rq
|
| (for 32\-bit targets) and
|
| \(lqmacho64\(rq
|
| -(for 64\-bit targets). Mach\-O is used as the object format on MacOS X. As Yasm currently only supports x86 and AMD64 instruction sets, it can only generate Mach\-O objects for Intel\-based Macs.
|
| +(for 64\-bit targets)\&. Mach\-O is used as the object format on MacOS X\&. As Yasm currently only supports x86 and AMD64 instruction sets, it can only generate Mach\-O objects for Intel\-based Macs\&.
|
| .SH "RDF"
|
| .PP
|
| -The RDOFF2 object format is a simple multi\-section format originally designed for NASM. It supports segment references but not WRT references. It was designed primarily for simplicity and has minimalistic headers for ease of loading and linking. A complete toolchain (linker, librarian, and loader) is distributed with NASM.
|
| +The RDOFF2 object format is a simple multi\-section format originally designed for NASM\&. It supports segment references but not WRT references\&. It was designed primarily for simplicity and has minimalistic headers for ease of loading and linking\&. A complete toolchain (linker, librarian, and loader) is distributed with NASM\&.
|
| .SH "WIN32"
|
| .PP
|
| -The Win32 object format produces object files compatible with Microsoft compilers (such as Visual C++) that target the 32\-bit x86 Windows platform. The object format itself is an extended version of COFF.
|
| +The Win32 object format produces object files compatible with Microsoft compilers (such as Visual C++) that target the 32\-bit x86 Windows platform\&. The object format itself is an extended version of COFF\&.
|
| .SH "WIN64"
|
| .PP
|
| The Win64 object format produces object files compatible with Microsoft compilers that target the 64\-bit
|
| \(lqx64\(rq
|
| -Windows platform. This format is very similar to the win32 object format, but produces 64\-bit objects.
|
| +Windows platform\&. This format is very similar to the win32 object format, but produces 64\-bit objects\&.
|
| .SH "XDF"
|
| .PP
|
| -The XDF object format is essentially a simplified version of COFF. It's a multi\-section relocatable format that supports 64\-bit physical and virtual addresses.
|
| +The XDF object format is essentially a simplified version of COFF\&. It\'s a multi\-section relocatable format that supports 64\-bit physical and virtual addresses\&.
|
| .SH "SEE ALSO"
|
| .PP
|
| \fByasm\fR(1),
|
| \fByasm_arch\fR(7)
|
| .SH "AUTHOR"
|
| .PP
|
| -\fBPeter\fR \fBJohnson\fR <peter@tortall.net>
|
| -.sp -1n
|
| -.IP "" 3n
|
| +\fBPeter Johnson\fR <\&peter@tortall\&.net\&>
|
| +.RS 4
|
| Author.
|
| +.RE
|
| .SH "COPYRIGHT"
|
| +.br
|
| Copyright \(co 2006 Peter Johnson
|
| +.br
|
|
|