Subject: [Boost-commit] svn:boost r80165 - in trunk/libs/context: build doc
From: oliver.kowalke_at_[hidden]
Date: 2012-08-24 04:26:56
Author: olli
Date: 2012-08-24 04:26:53 EDT (Fri, 24 Aug 2012)
New Revision: 80165
URL: http://svn.boost.org/trac/boost/changeset/80165
Log:
context: remove properties <abi>, <binary-format> from Jamfile; update docu
Removed:
trunk/libs/context/doc/tested.qbk
Text files modified:
trunk/libs/context/build/Jamfile.v2 | 160 ++++++---------------------------------
trunk/libs/context/doc/performance.qbk | 4
trunk/libs/context/doc/rationale.qbk | 15 ++-
trunk/libs/context/doc/reference.qbk | 14 +-
4 files changed, 45 insertions(+), 148 deletions(-)
Modified: trunk/libs/context/build/Jamfile.v2
==============================================================================
--- trunk/libs/context/build/Jamfile.v2 (original)
+++ trunk/libs/context/build/Jamfile.v2 2012-08-24 04:26:53 EDT (Fri, 24 Aug 2012)
@@ -23,45 +23,6 @@
<link>shared:<define>BOOST_CONTEXT_DYN_LINK=1
;
-local rule default_binary_format ( )
-{
- local tmp = elf ;
- if [ os.name ] = "MACOSX" { tmp = mach-o ; }
- if [ os.name ] = "NT" { tmp = pe ; }
- return $(tmp) ;
-}
-
-feature.feature binary-format
- : elf
- mach-o
- pe
- : propagated
- ;
-feature.set-default binary-format : [ default_binary_format ] ;
-
-
-local rule default_abi ( )
-{
- local tmp = sysv ;
- if [ os.name ] = "NT" { tmp = ms ; }
- else if [ os.platform ] = "ARM" { tmp = aapcs ; }
- else if [ os.platform ] = "MIPS" { tmp = o32 ; }
- return $(tmp) ;
-}
-
-feature.feature abi
- : aapcs
- eabi
- ms
- n32
- n64
- o32
- o64
- sysv
- : propagated
- ;
-feature.set-default abi : [ default_abi ] ;
-
actions gas
{
@@ -79,261 +40,192 @@
}
-rule configure ( properties * )
-{
- local result ;
-
- if ( ! ( <toolset>gcc in $(properties)
- || <toolset>intel in $(properties)
- || <toolset>msvc in $(properties) ) )
- {
- result = <build>no ;
- ECHO "toolset not supported" ;
- }
-
- return $(result) ;
-}
-
# ARM
alias asm_context_sources
: asm/fcontext_arm_aapcs_elf_gas.S
- : <abi>aapcs
- <architecture>arm
- <binary-format>elf
+ : <architecture>arm
<toolset>gcc
;
alias asm_context_sources
: [ make asm/fcontext_arm_aapcs_elf_gas.o : asm/fcontext_arm_aapcs_elf_gas.S : @gas ]
- : <abi>aapcs
- <architecture>arm
- <binary-format>elf
+ : <architecture>arm
;
# MIPS 32bit
alias asm_context_sources
: asm/fcontext_mips32_o32_elf_gas.S
- : <abi>o32
- <architecture>mips1
- <binary-format>elf
+ : <architecture>mips1
<toolset>gcc
;
alias asm_context_sources
: [ make asm/fcontext_mips32_o32_elf_gas.o : asm/fcontext_mips32_o32_elf_gas.S : @gas ]
- : <abi>o32
- <architecture>mips1
- <binary-format>elf
+ : <architecture>mips1
;
# POWERPC 32bit
alias asm_context_sources
: asm/fcontext_ppc32_sysv_elf_gas.S
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>power
- <binary-format>elf
<toolset>gcc
;
alias asm_context_sources
: [ make asm/fcontext_ppc32_sysv_elf_gas.o : asm/fcontext_ppc32_sysv_elf_gas.S : @gas ]
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>power
- <binary-format>elf
;
# POWERPC 64bit
alias asm_context_sources
: asm/fcontext_ppc64_sysv_elf_gas.S
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>power
- <binary-format>elf
<toolset>gcc
;
alias asm_context_sources
: [ make asm/fcontext_ppc64_sysv_elf_gas.o : asm/fcontext_ppc64_sysv_elf_gas.S : @gas ]
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>power
- <binary-format>elf
;
# I386
alias asm_context_sources
: asm/fcontext_i386_sysv_elf_gas.S
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>elf
<toolset>gcc
;
alias asm_context_sources
: asm/fcontext_i386_sysv_elf_gas.S
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>elf
<toolset>intel
;
alias asm_context_sources
: [ make asm/fcontext_i386_sysv_elf_gas.o : asm/fcontext_i386_sysv_elf_gas.S : @gas ]
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>elf
;
alias asm_context_sources
: asm/fcontext_i386_sysv_macho_gas.S
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>mach-o
<target-os>darwin
<toolset>gcc
;
alias asm_context_sources
: asm/fcontext_i386_sysv_macho_gas.S
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>mach-o
<target-os>darwin
<toolset>intel
;
alias asm_context_sources
: [ make asm/fcontext_i386_sysv_macho_gas.o : asm/fcontext_i386_sysv_macho_gas.S : @gas ]
- : <abi>sysv
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>mach-o
<target-os>darwin
;
alias asm_context_sources
: asm/fcontext_i386_ms_pe_masm.asm
- : <abi>ms
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>pe
<target-os>windows
<toolset>intel
;
alias asm_context_sources
: asm/fcontext_i386_ms_pe_masm.asm
- : <abi>ms
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>pe
<target-os>windows
<toolset>msvc
;
alias asm_context_sources
: [ make asm/fcontext_i386_ms_pe_masm.o : asm/fcontext_i386_ms_pe_masm.asm : @masm ]
- : <abi>ms
- <address-model>32
+ : <address-model>32
<architecture>x86
- <binary-format>pe
<target-os>windows
- <toolset>gcc
;
# X86_64
alias asm_context_sources
: asm/fcontext_x86_64_sysv_elf_gas.S
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>elf
<toolset>gcc
;
alias asm_context_sources
: asm/fcontext_x86_64_sysv_elf_gas.S
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>elf
<toolset>intel
;
alias asm_context_sources
: [ make asm/fcontext_x86_64_sysv_elf_gas.o : asm/fcontext_x86_64_sysv_elf_gas.S : @gas ]
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>elf
;
alias asm_context_sources
: asm/fcontext_x86_64_sysv_macho_gas.S
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>mach-o
<target-os>darwin
<toolset>gcc
;
alias asm_context_sources
: asm/fcontext_x86_64_sysv_macho_gas.S
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>mach-o
<target-os>darwin
<toolset>intel
;
alias asm_context_sources
: [ make asm/fcontext_x86_64_sysv_macho_gas.o : asm/fcontext_x86_64_sysv_macho_gas.S : @gas ]
- : <abi>sysv
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>mach-o
<target-os>darwin
;
alias asm_context_sources
: asm/fcontext_x86_64_ms_pe_masm.asm
- : <abi>ms
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>pe
<target-os>windows
<toolset>intel
;
alias asm_context_sources
: asm/fcontext_x86_64_ms_pe_masm.asm
- : <abi>ms
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>pe
<target-os>windows
<toolset>msvc
;
alias asm_context_sources
: [ make asm/fcontext_x86_64_ms_pe_masm.o : asm/fcontext_x86_64_ms_pe_masm.asm : @masm64 ]
- : <abi>ms
- <address-model>64
+ : <address-model>64
<architecture>x86
- <binary-format>pe
<target-os>windows
- <toolset>gcc
;
explicit asm_context_sources ;
Modified: trunk/libs/context/doc/performance.qbk
==============================================================================
--- trunk/libs/context/doc/performance.qbk (original)
+++ trunk/libs/context/doc/performance.qbk 2012-08-24 04:26:53 EDT (Fri, 24 Aug 2012)
@@ -28,10 +28,10 @@
]
[
[Intel Core2 Q6700 (64bit Linux)]
- [1472 cycles]
+ [1481 cycles]
[172 cycles]
[63 cycles]
- [60 cycles]
+ [25 cycles]
]
]
Modified: trunk/libs/context/doc/rationale.qbk
==============================================================================
--- trunk/libs/context/doc/rationale.qbk (original)
+++ trunk/libs/context/doc/rationale.qbk 2012-08-24 04:26:53 EDT (Fri, 24 Aug 2012)
@@ -48,7 +48,8 @@
C99 defines `setjmp()`/`longjmp()` to provide non-local jumps but it does not
require that ['longjmp()] preserves the current stack frame. Therefore, jumping
into a function which was exited via a call to ['longjmp()] is undefined
-[footnote ISO/IEC 9899:1999, 2005, 7.13.2.1:2].
+[footnote [@boost:/libs/context/doc/pdf/iso_c99.pdf ISO/IEC 9899:1999, 2005],
+7.13.2.1:2].
[heading ucontext_t]
@@ -61,7 +62,8 @@
The third argument of `makecontext()` specifies the number of integer arguments
that follow which will require function pointer cast if `func` will accept those
arguments which is undefined in C99
-[footnote ISO/IEC 9899:1999, 2005, J.2].
+[footnote [@boost:/libs/context/doc/pdf/iso_c99.pdf ISO/IEC 9899:1999, 2005],
+J.2].
The arguments in the var-arg list are required to be integers, passing pointers
in var-arg list is not guarantied to work, especially it will fail for
@@ -103,7 +105,8 @@
"The FpCsr and the MxCsr register must be saved and restored before any call or return
by any procedure that needs to modify them ..."
-[footnote 'Calling Conventions', Agner Fog].
+[footnote [@boost:/libs/context/doc/pdf/calling-conventions.pdf 'Calling Conventions',
+Agner Fog]].
[heading x86_64]
@@ -128,7 +131,8 @@
'Legacy Floating-Point Support']].
"The 64-bit Microsoft compiler does not use ST(0)-ST(7)/MM0-MM7".
-[footnote 'Calling Conventions', Agner Fog].
+[footnote [@boost:/libs/context/doc/pdf/calling-conventions.pdf 'Calling Conventions',
+Agner Fog]].
"XMM6-XMM15 must be preserved"
[footnote [@http://msdn.microsoft.com/en-us/library/9z1stfyw%28v=vs.100%29.aspx MSDN
@@ -140,7 +144,8 @@
"The control bits of the MxCsr register are callee-saved (preserved across calls),
while the status bits are caller-saved (not preserved). The x87 status word register is
caller-saved, whereas the x87 control word (FpCsr) is callee-saved."
-[footnote SysV ABI AMD64 Architecture Processor Supplement Draft Version 0.99.4, 3.2.1].
+[footnote [@boost:/libs/context/doc/pdf/x86_64-sysv.pdf SysV ABI AMD64 Architecture
+Processor Supplement Draft Version 0.99.4, 3.2.1]].
[endsect]
Modified: trunk/libs/context/doc/reference.qbk
==============================================================================
--- trunk/libs/context/doc/reference.qbk (original)
+++ trunk/libs/context/doc/reference.qbk 2012-08-24 04:26:53 EDT (Fri, 24 Aug 2012)
@@ -9,34 +9,34 @@
[heading ARM]
-* AAPCS ABI: Procedure Call Standard for the ARM Architecture
-* AAPCS/LINUX: ARM GNU/Linux Application Binary Interface Supplement
+* AAPCS ABI: [@boost:/libs/context/doc/pdf/arm-aapcs.pdf Procedure Call Standard for the ARM Architecture]
+* AAPCS/LINUX: [@boost:/libs/context/doc/pdf/arm-linux-aapcs.pdf ARM GNU/Linux Application Binary Interface Supplement]
[heading MIPS]
-* O32 ABI: SYSTEM V APPLICATION BINARY INTERFACE, MIPS RISC Processor Supplement
+* O32 ABI: [@boost:/libs/context/doc/pdf/mips-o32.pdf SYSTEM V APPLICATION BINARY INTERFACE, MIPS RISC Processor Supplement]
[heading PowerPC32]
-* SYSV ABI: SYSTEM V APPLICATION BINARY INTERFACE PowerPC Processor Supplement
+* SYSV ABI: [@boost:/libs/context/doc/pdf/ppc32-sysv.pdf SYSTEM V APPLICATION BINARY INTERFACE PowerPC Processor Supplement]
[heading PowerPC64]
-* SYSV ABI: PowerPC User Instruction Set Architecture, Book I
+* SYSV ABI: [@boost:/libs/context/doc/pdf/ppc64-sysv.pdf PowerPC User Instruction Set Architecture, Book I]
[heading X86-32]
-* SYSV ABI: SYSTEM V APPLICATION BINARY INTERFACE, Intel386TM Architecture Processor Supplement
+* SYSV ABI: [@boost:/libs/context/doc/pdf/x86_32-sysv.pdf SYSTEM V APPLICATION BINARY INTERFACE, Intel386TM Architecture Processor Supplement]
* MS PE: [@http://msdn.microsoft.com/en-us/library/k2b2ssfy.aspx Calling Conventions]
[heading X86-64]
-* SYSV ABI: System V Application Binary Interface, AMD64 Architecture Processor Supplement
+* SYSV ABI: [@boost:/libs/context/doc/pdf/x86_64-sysv.pdf System V Application Binary Interface, AMD64 Architecture Processor Supplement]
* MS PE: [@http://msdn.microsoft.com/en-us/library/7kcdt6fy%28VS.80%29.aspx x64 Software Conventions]
Deleted: trunk/libs/context/doc/tested.qbk
==============================================================================
--- trunk/libs/context/doc/tested.qbk 2012-08-24 04:26:53 EDT (Fri, 24 Aug 2012)
+++ (empty file)
@@ -1,74 +0,0 @@
-[/
- Copyright Oliver Kowalke 2009.
- Distributed under the Boost Software License, Version 1.0.
- (See accompanying file LICENSE_1_0.txt or copy at
- http://www.boost.org/LICENSE_1_0.txt
-]
-
-[section:tested Tested Platforms]
-
-[table
- [[Platform] [OS] [Compiler] [ABI]]
- [
- [ARM (ARM926EJ-S)]
- [Debian GNU/Linux (Lenny)]
- [GCC 4.4.4]
- [ARM APCS (Linux)]
- ]
- [
- [MIPS (MIPS 24K)]
- [Debian GNU/Linux (Lenny)]
- [GCC 4.3.2]
- [O32]
- ]
- [
- [MIPS (O2 / MIPS R5000)]
- [Debian GNU/Linux (Lenny)]
- [GCC 4.3.2]
- [O32]
- ]
- [
- [PowerPC (7400)]
- [Debian GNU/Linux (Lenny)]
- [GCC 4.3.2]
- [SYSV]
- ]
- [
- [X86_64 (Intel Core2 Quad)]
- [Ubuntu GNU/Linux (Lucid Lynx)]
- [GCC 4.4.3]
- [SYSV]
- ]
- [
- [X86_64]
- [Windows 7]
- [MS VC 10.0]
- [PE]
- ]
- [
- [I386]
- [Debian GNU/Linux (Lenny)]
- [GCC 4.4.3]
- [SYSV]
- ]
- [
- [I386]
- [FreeBSD 8.0]
- [GCC 4.2.1]
- [SYSV]
- ]
- [
- [I386]
- [OpenSolaris 2009.06]
- [GCC 4.3.2]
- [SYSV]
- ]
- [
- [I386]
- [Windows XP]
- [MSVC 9.0]
- [PE]
- ]
-]
-
-[endsect]