Mercurial > hg > index.cgi
diff docs/manual/manual.html @ 565:fc072f6cde09
Update documentation to reflect includebin offset/length feature
author | William Astle <lost@l-w.ca> |
---|---|
date | Thu, 21 Dec 2023 22:16:12 -0700 |
parents | 8c6c3363e18e |
children |
line wrap: on
line diff
--- a/docs/manual/manual.html Thu Dec 21 22:14:25 2023 -0700 +++ b/docs/manual/manual.html Thu Dec 21 22:16:12 2023 -0700 @@ -153,44 +153,44 @@ ></DT ><DT >3.6.2. <A -HREF="#AEN375" +HREF="#AEN381" >Address Definition</A ></DT ><DT >3.6.3. <A -HREF="#AEN426" +HREF="#AEN432" >Conditional Assembly</A ></DT ><DT >3.6.4. <A -HREF="#AEN497" +HREF="#AEN503" >OS9 Target Directives</A ></DT ><DT >3.6.5. <A -HREF="#AEN522" +HREF="#AEN528" >Miscelaneous Directives</A ></DT ></DL ></DD ><DT >3.7. <A -HREF="#AEN562" +HREF="#AEN568" >Macros</A ></DT ><DT >3.8. <A -HREF="#AEN585" +HREF="#AEN591" >Structures</A ></DT ><DT >3.9. <A -HREF="#AEN606" +HREF="#AEN612" >Object Files and Sections</A ></DT ><DT >3.10. <A -HREF="#AEN670" +HREF="#AEN676" >Assembler Modes and Pragmas</A ></DT ><DT @@ -200,43 +200,43 @@ ></DT ><DT >3.12. <A -HREF="#AEN826" +HREF="#AEN832" >Cycle Counts</A ></DT ></DL ></DD ><DT >4. <A -HREF="#AEN832" +HREF="#AEN838" >LWLINK</A ></DT ><DD ><DL ><DT >4.1. <A -HREF="#AEN835" +HREF="#AEN841" >Command Line Options</A ></DT ><DT >4.2. <A -HREF="#AEN932" +HREF="#AEN938" >Linker Operation</A ></DT ><DT >4.3. <A -HREF="#AEN946" +HREF="#AEN952" >Linking Scripts</A ></DT ><DT >4.4. <A -HREF="#AEN1013" +HREF="#AEN1019" >Format Specific Linking Notes</A ></DT ><DD ><DL ><DT >4.4.1. <A -HREF="#AEN1016" +HREF="#AEN1022" >OS9 Modules</A ></DT ></DL @@ -245,14 +245,14 @@ ></DD ><DT >5. <A -HREF="#AEN1028" +HREF="#AEN1034" >Libraries and LWAR</A ></DT ><DD ><DL ><DT >5.1. <A -HREF="#AEN1032" +HREF="#AEN1038" >Command Line Options</A ></DT ></DL @@ -274,12 +274,12 @@ ></DT ><DT >6-1. <A -HREF="#AEN1115" +HREF="#AEN1121" >Object File Term Types</A ></DT ><DT >6-2. <A -HREF="#AEN1145" +HREF="#AEN1151" >Object File Operator Numbers</A ></DT ></DL @@ -1254,7 +1254,13 @@ >INCLUDEBIN <CODE CLASS="PARAMETER" >filename</CODE -></DT +>[,<CODE +CLASS="PARAMETER" +>start</CODE +>[,<CODE +CLASS="PARAMETER" +>length</CODE +>]]</DT ><DD ><P >Treat the contents of <CODE @@ -1275,6 +1281,20 @@ > Please note that absolute path detection including drive letters will not function correctly on Windows platforms. Non-absolute inclusion will work, however.</P +><P +> The optional <CODE +CLASS="PARAMETER" +>start</CODE +> parameter allows you to set +the byte offset to start reading from the binary file. Positive values are +from the beginning of the file, negative values are from the end of the file.</P +><P +> The optional <CODE +CLASS="PARAMETER" +>length</CODE +> parameter allows you to set +the number of bytes read from the binary file. If missing, then the file is +read to the end.</P ></DD ><DT >FILL <CODE @@ -1302,7 +1322,7 @@ ><HR><H3 CLASS="SECTION" ><A -NAME="AEN375" +NAME="AEN381" >3.6.2. Address Definition</A ></H3 ><P @@ -1448,7 +1468,7 @@ ><HR><H3 CLASS="SECTION" ><A -NAME="AEN426" +NAME="AEN432" >3.6.3. Conditional Assembly</A ></H3 ><P @@ -1623,7 +1643,7 @@ ><HR><H3 CLASS="SECTION" ><A -NAME="AEN497" +NAME="AEN503" >3.6.4. OS9 Target Directives</A ></H3 ><P @@ -1690,7 +1710,7 @@ ><HR><H3 CLASS="SECTION" ><A -NAME="AEN522" +NAME="AEN528" >3.6.5. Miscelaneous Directives</A ></H3 ><P @@ -1804,7 +1824,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN562" +NAME="AEN568" >3.7. Macros</A ></H2 ><P @@ -1903,7 +1923,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN585" +NAME="AEN591" >3.8. Structures</A ></H2 ><P @@ -1996,7 +2016,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN606" +NAME="AEN612" >3.9. Object Files and Sections</A ></H2 ><P @@ -2213,7 +2233,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN670" +NAME="AEN676" >3.10. Assembler Modes and Pragmas</A ></H2 ><P @@ -2694,7 +2714,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN826" +NAME="AEN832" >3.12. Cycle Counts</A ></H2 ><P @@ -2733,7 +2753,7 @@ CLASS="CHAPTER" ><HR><H1 ><A -NAME="AEN832" +NAME="AEN838" ></A >Chapter 4. LWLINK</H1 ><P @@ -2744,7 +2764,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN835" +NAME="AEN841" >4.1. Command Line Options</A ></H2 ><P @@ -2942,7 +2962,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN932" +NAME="AEN938" >4.2. Linker Operation</A ></H2 ><P @@ -2998,7 +3018,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN946" +NAME="AEN952" >4.3. Linking Scripts</A ></H2 ><P @@ -3205,7 +3225,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN1013" +NAME="AEN1019" >4.4. Format Specific Linking Notes</A ></H2 ><P @@ -3218,7 +3238,7 @@ ><HR><H3 CLASS="SECTION" ><A -NAME="AEN1016" +NAME="AEN1022" >4.4.1. OS9 Modules</A ></H3 ><P @@ -3294,7 +3314,7 @@ CLASS="CHAPTER" ><HR><H1 ><A -NAME="AEN1028" +NAME="AEN1034" ></A >Chapter 5. Libraries and LWAR</H1 ><P @@ -3313,7 +3333,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN1032" +NAME="AEN1038" >5.1. Command Line Options</A ></H2 ><P @@ -3514,7 +3534,7 @@ ><DIV CLASS="TABLE" ><A -NAME="AEN1115" +NAME="AEN1121" ></A ><P ><B @@ -3586,7 +3606,7 @@ ><DIV CLASS="TABLE" ><A -NAME="AEN1145" +NAME="AEN1151" ></A ><P ><B