add arch.7 man page with architecture-specific details
ClosedPublic
Actions

Authored by emaste on Jul 4 2016, 3:16 PM.

Details

Reviewers

jhb
andrew

Commits

rS303033: add an arch.7 man page with architecture-specific details

Summary

Based on https://wiki.freebsd.org/EdMaste/ArchitectureSpecifics

Needs more work; posting for now to get feedback on correct markup

Diff Detail

Lint

Lint Skipped

Unit

Tests Skipped

Event Timeline

emaste updated this revision to Diff 18126.Jul 4 2016, 3:16 PM

emaste retitled this revision from to add arch.7 man page with architecture-specific details.

emaste updated this object.

emaste edited the test plan for this revision. (Show Details)

emaste added a subscriber: wblock.

emaste added inline comments.

share/man/man7/arch.7
113	One missing part from the wiki is footnotes on some of these: double precision[1] [1] Prior to FreeBSD 11, armv6 is built with the softfp ABI by default, it uses hard float, but passed floating-point arguments as soft float, i.e. in integer registers.

wblock added inline comments.Jul 4 2016, 5:44 PM

share/man/man7/arch.7
43	This "size" should be capitalized. The later ones are part of reserved words.
127	Built-in and predefined really mean the same thing, so this is redundant. Predefined is probably the better choice for a single one.
132	s/the following/this/

connect to Makefile
incorporate improvements from @wblock

emaste added subscribers: jhb, andrew, br.Jul 4 2016, 5:51 PM

emaste added a subscriber: imp.

br awarded a token.Jul 4 2016, 7:38 PM

It should be trivial to merge new manpages into 11 btw, so I think the history should optimistically reference 11.0. :)

Another interesting category (which can be added later) is what ELF header constants are used for different platforms. (I had to figure this out for the libkvm changes. For example, mipsn32 and mipso32 share the EM_xxx and use a flag to differentiate)

This revision is now accepted and ready to land.Jul 5 2016, 1:25 PM