Skip to content

Commit adf6319

Browse files
jeplerdpgeorge
authored andcommitted
docs/develop/gettingstarted: Document %.sz and %.pp targets.
Signed-off-by: Jeff Epler <[email protected]>
1 parent 1921d22 commit adf6319

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/develop/gettingstarted.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -285,6 +285,21 @@ See also :ref:`writingtests`.
285285
Additional make targets for developers
286286
--------------------------------------
287287

288+
In all ``make``-based ports, there is a target to print the size of a specific object file.
289+
When a change is confined to a single file, this is useful when testing variations to find smaller alternatives.
290+
291+
For instance, to print the size of ``objstr.o`` in the ``py/`` directory when making a unix standard build:
292+
293+
.. code-block:: bash
294+
295+
$ make build-standard/py/objstr.sz
296+
297+
Similarly, there is a target to save the preprocessed version of a file:
298+
299+
.. code-block:: bash
300+
301+
$ make build-standard/py/objstr.pp
302+
288303
In ``ports/unix`` there are additional targets related to running tests:
289304

290305
.. code-block:: bash

0 commit comments

Comments
 (0)