OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook] Why does <menuchoice> support multiple <guimenuitem> elements?

On 7/22/20 3:45 AM, Peter Flynn wrote:
> On 21/07/2020 08:57, David O'Brien wrote:
>> I have a question about the following:
>> GUIMenuItem identifies a terminal selection from a menu in a
>> graphical user interface. In particular, this is distinct from a menu
>> (GUIMenu) and a submenu (GUISubmenu). The distinction between a
>> GUIMenuItem and a GUISubmenu is simply whether or not the selection
>> is terminal or leads to an additional submenu.*
>> *https://tdg.docbook.org/tdg/4.5/guimenuitem.html
>> If a GUIMenuItem is terminal, shouldn't there be only one? Our
>> writers regularly include >1 inside <menuchoice> but we don't get any
>> validation errors. What did I miss?
> What would concern me more is why the authors are including more than one item. Perhaps they believe
> that GUIMenuItem is for representing all the items available n the menu at a certain level, and they
> may therefore be puzzled as to why there isn't an option to say "here are the items you will see
> displayed â just click the one saying 'Blort'"
> Peter
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org

We can constrain the DocBook more with hooks (we use pre-commit a lot) but I guess I was mostly
curious about why it was allowed in the first place.

As far as authors go, I think it's a combination of not understanding DocBook and for some UIs it
can be hard to tell where GUIMenu|SubMenu, etc., end and GUILabel begins. In this particular case
they were referring to tabs in the OpenStack web UI, some of which contain "subtabs."

Thanks for the input.


"Unix never says please."
~ Rob Pike

Attachment: signature.asc
Description: OpenPGP digital signature

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]