Re: [PATCH v2 1/2] introduction: document that leXX can mean guest endian-ness

On Wed, Feb 12, 2014 at 12:09:52PM +0200, Michael S. Tsirkin wrote:
> It has a different meaning in the legacy environments,
> document this.
> 
> Signed-off-by: Michael S. Tsirkin <>
> ---
>  introduction.tex | 8 +++++---
>  1 file changed, 5 insertions(+), 3 deletions(-)
> 
> diff --git a/introduction.tex b/introduction.tex
> index ba57419..692e25b 100644
> --- a/introduction.tex
> +++ b/introduction.tex
> @@ -41,8 +41,8 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S
>  
>  \begin{longtable}{l p{5in}}
>  	\phantomsection\label{intro:rfc2119}\textbf{[RFC2119]} & S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, \newline\url{http://www.ietf.org/rfc/rfc2119.txt}, March 1997\\
> -	\phantomsection\label{intro:S390 PoP}\textbf{[S390 PoP]} & z/Architecture Principles of Operation, IBM Publication SA22-7832, \newline\url{http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr009.pdf}, and any future revisions\\
> -	\phantomsection\label{intro:S390 Common I/O}\textbf{[S390 Common I/O]} & ESA/390 Common I/O-Device and Self-Description, IBM Publication SA22-7204, \newline\url{http://publibfp.dhe.ibm.com/cgi-bin/bookmgr/BOOKS/dz9ar501/CCONTENTS}, and any future revisions\\
> +	\phantomsection\label{intro:S390 PoP}\textbf{[S390 PoP]} & z/Architecture Principles of Operation, \newline IBM Publication SA22-7832\\
> +	\phantomsection\label{intro:S390 Common I/O}\textbf{[S390 Common I/O]} & ESA/390 Common I/O-Device and Self-Description, \newline IBM Publication SA22-7204\\
>  	\phantomsection\label{intro:PCI}\textbf{[PCI]} &
>  	Conventional PCI Specifications,
>  	\newline\url{http://www.pcisig.com/specifications/conventional/},

Please ignore this chunk, it's clearly uninitentional.

> @@ -68,7 +68,9 @@ conventions are used:
>  \item[u8, u16, u32, u64] An unsigned integer of the specified length in bits.
>  
>  \item[le16, le32, le64] An unsigned integer of the specified length in bits,
> -in little-endian byte order.
> +in little-endian byte order; when used in a legacy environment -
> +an unsigned integer of the specified length in bits, in legacy
> +guest-endian byte order.
>  
>  \item[be16, be32, be64] An unsigned integer of the specified length in bits,
>  in big-endian byte order.
> -- 
> MST
>