add "Flags" title in format parameter of sprintf

[sad270]

In format parameter of sprintf function, there is no title for the flags parameters.

BEFORE
Flags seems to be for Argnum parameter

AFTER
(I make the change with my browser inspector)
Flags are in a flags section, we understand that it's for flags

[tiffany-taylor]

"Flags" as a title already appears on the page, but it shows as a centered title above the table, which is confusing to readers.

Could you correct that instead of your current suggestion, please?

[sad270]

I have to surround the section with formalpara. I will do it in some hours 😄

[sad270]

Hi @tiffany-taylor
The second "Flags" is the table title. When I remove it, my document didn't validate.

I have those errors :

The document didn't validate
/phpdoc/doc-base/.manual.xml:1159609:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1165383:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1167215:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1176744:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1177258:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1177769:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"

IMO we have to have both (section and table titles). It will be weird to have the title twice but less confusing than not have section title. WDYT ?

[Girgias]

You don't need this wrapping para tag

[tiffany-taylor]

Ran your suggestions locally. The <para> container is still needed, but <table> can safely be changed to <informaltable>.

[sad270]

done

[Girgias]

Suggested change

<table>

<title>Flags</title>

<informaltable>

And fix the end tag

[tiffany-taylor]

Hi @tiffany-taylor The second "Flags" is the table title. When I remove it, my document didn't validate.

I have those errors :

The document didn't validate
/phpdoc/doc-base/.manual.xml:1159609:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1165383:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1167215:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1176744:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1177258:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"
/phpdoc/doc-base/.manual.xml:1177769:22: error: element "tgroup" not allowed yet; expected element "caption", "info", "title" or "titleabbrev"

IMO we have to have both (section and table titles). It will be weird to have the title twice but less confusing than not have section title. WDYT ?

Please see Gina's suggestions. Changing the <table> element to an <informaltable> and removing the <title> that appears inside the <table> container works nicely, I think.

This is what I see locally when I render with the changes.

[sad270]

It's done !
🙏🏻 Thanks @tiffany-taylor @Girgias for the help !