Re: Wrong tags in a11y guide newly added section

["Vincent Alexander" <vpalexander gmail com>]

Please feel free to email me directly with all corrections,
suggestions, etc. concerning the GNOME Accessibility Guide and its
three major portions for users, developers and OS-distro testers.

If you have the ability/clearance to correct minor items like
mistagged text, etc., please feel free to do so; otherwise just email
me with your concerns.

Luca - your tag corrections are appreciated; I also agree we ought to
stick to whatever convention we now have for referring to OS-specific
shift keys...they all seem to have one, but it's called something
different in each case.

On 7/16/08, Shaun McCance <shaunm gnome org> wrote:
> On Wed, 2008-07-16 at 12:52 +0200, Luca Ferretti wrote:
>> Hi,
>>
>> I've started to update the Italian translation for the accessibility
>> guide and I've found the following wrong tags:
>>
>>         gnome-access-guide.xml:7(para)
>>         <keycap>Alt-F1</keycap> - display and activate the GNOME Desktop
>>         menu bar. This grants access to the
>>         <guilabel>Applications</guilabel>, <guilabel>Places</guilabel>
>>         and <guilabel>System</guilabel> menu bar items.
>>
>> <keycap>Alt-F1</keycap> should be
>> <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>
>>
>> <guilabel> should are <guimenu>
>>
>>         gnome-access-guide.xml:15(para)
>>         <keycap>Alt-F2</keycap> - summons the <emphasis>Run</emphasis>
>>         dialog, where you can issue terminal commands with or without
>>         parameters. If a file needs to be passed as one of these
>>         parameters, use the <guilabel>Run With File</guilabel> button to
>>         easily locate the file needed. This dialog also presents an
>>         alternate list of known applications which may be easier to
>>         navigate for some than the typical <keycap>Alt-F1</keycap>
>>         approach.
>>
>> Again, missing <keycombo> plus: <emphasis>Run</emphasis> should be
>> <application>Run Application</application> or similar (I've to check
>> user guide); <guilabel>Run With File</guilabel> should be <guibutton>.
>>
>> Note in this section there are a lot of simple <keycap></> instead
>> <keycombo><keycap></></>, I'm not reporting all of them.
>>
>> Is it OK let me fix them on svn?
>
> Vincent Alexander has been doing a lot of work on the
> Accessibility Guide lately.  I'm CCing him to make sure
> he sees it.  DocBook is a beast of a language, and it's
> easy to make mistakes like this while learning.  Just
> let Vincent know about these issues.
>
>> PS note also that
>> 1) For Solaris systems, this key is <keycap>Ctrl-Esc</keycap>
>>   * s/key/shourtcut,keybinding ??
>
> According to the Style Guide: "the shortcut keys are Ctrl-Esc".
> I think the plural sounds odd, personally.
>
>> 2) For Solaris systems, this key is <keycap>Meta-R</keycap> (as with
>> Microsoft Windows). A meta- or super-key is an OS-logo shift key
>>   * as above, plus "OS-logo shift key"??? what this means?
>
> I don't think we hyphenate "meta key" or "super key".  On most
> GNU/Linux distributions on PCs, The Windows logo key is mapped
> to Super.  We generally refer to it as Super, then explain that
> it's the "Windows logo key".
>
> I don't know what modern keyboards from Sun look like.  Do they
> have a Solaris logo key?  Don't they have an actual Meta key with
> the diamond on them?  What happens with Mac keybaords?  Does the
> Apple key get mapped to Super?  Meta?  Hyper?
>
> --
> Shaun
>
>
>