Anonymous | Login | 2023-06-11 00:40 UTC |
Main | My View | View Issues | Change Log | Docs |
Viewing Issue Simple Details [ Jump to Notes ] | [ Issue History ] [ Print ] | |||||||||||
ID | Category | Severity | Type | Date Submitted | Last Update | |||||||
0001709 | [Issue 8 drafts] Shell and Utilities | Editorial | Omission | 2023-05-07 13:54 | 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. | |||||||||||
Tags | No tags attached. | |||||||||||
Attached Files | ||||||||||||
|
There are no notes attached to this issue. |
Mantis 1.1.6[^] Copyright © 2000 - 2008 Mantis Group |