[9front] [PATCH] update a.out manpage to be 64 bit inclusive

[9front] [PATCH] update a.out manpage to be 64 bit inclusive

[jacob gw]

---
diff fd9679d97b0bb7b8849f84f50c708d5f733708e1 ea21c85c5ced615ab90d7efca9a100596cf71333
--- a/sys/man/6/a.out	Sat Jun  5 09:40:28 2021
+++ b/sys/man/6/a.out	Sat Jun  5 14:48:10 2021
@@ -52,6 +52,10 @@
 Sizes are expressed in bytes.
 The size of the header is not included in any of the other sizes.
 .PP
+There may be an extra 8 bytes after the header on 64 bit systems.
+These bytes represent the entry point in a 64 bit address space.
+You can tell that these will be there if magic & HDR_MAGIC.
+.PP
 When a Plan 9 binary file is executed,
 a memory image of three segments is
 set up: the text segment, the data segment, and the stack.
@@ -93,7 +97,7 @@
 entries, each laid out as:
 .IP
 .EX
-uchar value[4];
+uchar value[4]; /* value[8] on 64 bit systems */
 char  type;
 char  name[\f2n\fP];   /* NUL-terminated */
 .EE
@@ -141,6 +145,9 @@
 .TP
 .B p
 function parameter symbol
+.TP
+.B m
+frame symbol
 .RE
 .PD
 .PP

Re: [9front] [PATCH] update a.out manpage to be 64 bit inclusive

[ori]

Quoth jacob gw <jacoblevgw@gmail.com>:
> ---
> diff fd9679d97b0bb7b8849f84f50c708d5f733708e1 ea21c85c5ced615ab90d7efca9a100596cf71333
> --- a/sys/man/6/a.out	Sat Jun  5 09:40:28 2021
> +++ b/sys/man/6/a.out	Sat Jun  5 14:48:10 2021
> @@ -52,6 +52,10 @@
>  Sizes are expressed in bytes.
>  The size of the header is not included in any of the other sizes.
>  .PP
> +There may be an extra 8 bytes after the header on 64 bit systems.
> +These bytes represent the entry point in a 64 bit address space.
> +You can tell that these will be there if magic & HDR_MAGIC.

How about this wording?

When HDR_MAGIC is set, an 8 byte entry point
is included in the header. This is used in
place of the 4 byte header.

> +.PP
>  When a Plan 9 binary file is executed,
>  a memory image of three segments is
>  set up: the text segment, the data segment, and the stack.
> @@ -93,7 +97,7 @@
>  entries, each laid out as:
>  .IP
>  .EX
> -uchar value[4];
> +uchar value[4]; /* value[8] on 64 bit systems */
>  char  type;
>  char  name[\f2n\fP];   /* NUL-terminated */
>  .EE
> @@ -141,6 +145,9 @@
>  .TP
>  .B p
>  function parameter symbol
> +.TP
> +.B m
> +frame symbol
>  .RE
>  .PD
>  .PP
>