display

• ApplicationResources.properties, xwiki-platform: the parameter names and descriptions shown in the Edit Macro dialog, which replace the descriptions of DisplayMacroParameters, including the "e.g. 'HMyHeading'" hint of section.
• AbstractIncludeMacro, xwiki-platform: the reference resolution, recursion check and inline conversion shared with the include macro.

C1: the name and the description are not translated in French and German, which is fixed on l10n.xwiki.org.

C9: used by one example of the documentation, to avoid repeating the title of a displayed section.

C1, minor: hidden, but shown when the macro already sets it, like {{display page="Sandbox/TestPage1"/}} . The Edit Macro dialog of that macro then shows two alternatives, "Select parameter Resource" with a Page field and "Select parameter page" with another Page field, both with the description "The reference of the page to display.", with no way to tell them apart.

C4, minor: in the same case, a plain text field, while the reference alternative next to it has a page picker.

C9: hidden from the dialog of a new macro.

C2: not mandatory itself, but it is the only shown alternative of the required Reference feature; no default makes sense, the current page would display itself.

C4: a page picker that finds the page by its title, its name or its reference, and also accepts a typed reference.

C1: the description "An optional id of a section to include in the specified page." uses "include", the term of the other macro, and does not say that the id is "H" followed by the heading title without spaces, like HMyHeading, so the user cannot guess what to type. The descriptor annotation gives the hint "e.g. 'HMyHeading'", but the translation that replaces it drops it. Open the Edit Macro dialog of {{display reference="Sandbox.TestPage1"/}} , Optional parameters.

C4: a plain text field where the user must type a generated heading id, while the headings of the chosen page could be offered in a picker: to display the "My Heading" section the user has to work out and type {{display reference="Sales.Reports.WebHome" section="HMyHeading"/}} , and a heading with accented letters gives an id with hexadecimal codes, like HCafE9.

C8: marked as advanced; used by two examples of the documentation, but not by the most common one.

C9: hidden from the Edit Macro dialog; the Page picker sets the reference type. Shown, as an advanced select of 13 entity types, only when the macro already sets it.