0001709: Specify handling of '#' in macro definitions

Austin Group Defect Tracker

Aardvark Mark IV

Viewing Issue Simple Details [ Jump to Notes ]

[ Issue History ] [ Print ]

Category

Severity

Type

Date Submitted

Last Update

0001709

[Issue 8 drafts] Shell and Utilities

Editorial

Omission

2023-05-07 13:54

Reporter

rillig

View Status

public

Assigned To

Priority

normal

Resolution

Open

Status

New

Product Version

Draft 3

Name

Roland Illig

Organization

User Reference

Section

make

Page Number

3112

Line Number

104860

Final Accepted Text

Summary

0001709: Specify handling of '#' in macro definitions

Description

The section about macro definitions seems unorganized.

For example, the handling of '#' characters is only specified for the '?=' macro definition operator but not for the 5 other operators.

There should be a general introduction before definiting the specific assignment operators. The handling of '#' characters and white-space characters around the macro name, the operator and the macro value should take place in this general introduction.

     Macro definitions have the form 'name op value', where:

           name    is a single-word macro name,

           op      is one of the macro definition operators described
                   below, and

           value   is interpreted according to the macro definition operator.

As a reader, I also wonder why 'string1' is named so unspecifically instead of using 'name' for it. On the other hand, I understand that 'string2' is interpreted differently for each operator, thus the name 'value' wouldn't fit perfectly.

Desired Action

Reorganize the section 'Macros' to have the general parts first, followed by the operator-specific parts.

Issue History
Date Modified	Username	Field	Change
2023-05-07 13:54	rillig	New Issue
2023-05-07 13:54	rillig	Name	=> Roland Illig
2023-05-07 13:54	rillig	Section	=> make
2023-05-07 13:54	rillig	Page Number	=> 3112
2023-05-07 13:54	rillig	Line Number	=> 104860

Relationships