Mercurial > hg > index.cgi

view docs/manual/c806.html @ 434:052c5f335a92

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix bug in like terms collection in expression simplification Like term collection would lose the actual "variable" part of the term if the second term collected happened to have no coefficient. This would cause the expression to take the value of the calculated coefficient which is obviously wrong. Thanks to hider <stego@satx.rr.com> for reporting the bug and providing a proper test case. Observation: this bug has been present since the first pre-release of lwtools 3.0 when the algebraic expression system was introduced. Apparently people tend not to create expressions that trigger the like terms handler. The specific conditions require the symbol to be undefined and the second operand to the addition has to have no coefficient so it's likely a fairly rare scenario. Still, it is somewhat surprising that nobody tripped on it before now.
author William Astle <lost@l-w.ca>
date Mon, 23 Jan 2017 22:58:36 -0700
parents fc166b3bbae3
children 566660ef3b4d
line wrap: on
line source

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>LWLINK</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="LW Tool Chain"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Cycle Counts"
HREF="x800.html"><LINK
REL="NEXT"
TITLE="Linker Operation"
HREF="x906.html"></HEAD
><BODY
CLASS="CHAPTER"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>LW Tool Chain</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="x800.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="x906.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="AEN806"
></A
>Chapter 4. LWLINK</H1
><P
>The LWTOOLS linker is called LWLINK. This chapter documents the various features
of the linker.</P
><DIV
CLASS="SECTION"
><H1
CLASS="SECTION"
><A
NAME="AEN809"
>4.1. Command Line Options</A
></H1
><P
>The binary for LWLINK is called "lwlink". Note that the binary is in lower
case. lwlink takes the following command line arguments.</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><CODE
CLASS="OPTION"
>--decb</CODE
>, <CODE
CLASS="OPTION"
>-b</CODE
></DT
><DD
><P
>Selects the DECB output format target. This is equivalent to <CODE
CLASS="OPTION"
>--format=decb</CODE
></P
></DD
><DT
><CODE
CLASS="OPTION"
>--output=FILE</CODE
>, <CODE
CLASS="OPTION"
>-o FILE</CODE
></DT
><DD
><P
>This option specifies the name of the output file. If not specified, the
default is <CODE
CLASS="OPTION"
>a.out</CODE
>.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--format=TYPE</CODE
>, <CODE
CLASS="OPTION"
>-f TYPE</CODE
></DT
><DD
><P
>This option specifies the output format. Valid values are <CODE
CLASS="OPTION"
>decb</CODE
>
and <CODE
CLASS="OPTION"
>raw</CODE
></P
></DD
><DT
><CODE
CLASS="OPTION"
>--raw</CODE
>, <CODE
CLASS="OPTION"
>-r</CODE
></DT
><DD
><P
>This option specifies the raw output format.
It is equivalent to <CODE
CLASS="OPTION"
>--format=raw</CODE
>
and <CODE
CLASS="OPTION"
>-f raw</CODE
></P
></DD
><DT
><CODE
CLASS="OPTION"
>--script=FILE</CODE
>, <CODE
CLASS="OPTION"
>-s</CODE
></DT
><DD
><P
>This option allows specifying a linking script to override the linker's
built in defaults.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--section-base=SECT=BASE</CODE
></DT
><DD
><P
>Cause section SECT to load at base address BASE. This will be prepended
to the built-in link script. It is ignored if a link script is provided.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--map=FILE</CODE
>, <CODE
CLASS="OPTION"
>-m FILE</CODE
></DT
><DD
><P
>This will output a description of the link result to FILE.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--library=LIBSPEC</CODE
>, <CODE
CLASS="OPTION"
>-l LIBSPEC</CODE
></DT
><DD
><P
>Load a library using the library search path. LIBSPEC will have "lib" prepended
and ".a" appended.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--library-path=DIR</CODE
>, <CODE
CLASS="OPTION"
>-L DIR</CODE
></DT
><DD
><P
>Add DIR to the library search path.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--debug</CODE
>, <CODE
CLASS="OPTION"
>-d</CODE
></DT
><DD
><P
>This option increases the debugging level. It is only useful for LWTOOLS
developers.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--help</CODE
>, <CODE
CLASS="OPTION"
>-?</CODE
></DT
><DD
><P
>This provides a listing of command line options and a brief description
of each.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--usage</CODE
></DT
><DD
><P
>This will display a usage summary
of each command line option.</P
></DD
><DT
><CODE
CLASS="OPTION"
>--version</CODE
>, <CODE
CLASS="OPTION"
>-V</CODE
></DT
><DD
><P
>This will display the version of LWLINK.</P
></DD
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="x800.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="x906.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Cycle Counts</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Linker Operation</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>