Re: [Audacity-devel] Documentation changes needed?

[Paul L. <pau...@gm...>]

On Mon, Dec 5, 2016 at 3:37 PM, Gale Andrews <ga...@au...> wrote:

> On 5 December 2016 at 18:54, Peter Sampson
> <pet...@gm...> wrote:
> > Comments inline ...
> >
> > On Mon, Dec 5, 2016 at 6:13 PM, Paul Licameli <pau...@gm...>
> > wrote:
> >>
> >> Peter,  here is a list of things I have done in 2.1.3 that may need
> >> changes in documentation.  Some minor ones perhaps don't.
> >>
> >> Truncate silence effect can process tracks independently.  (The effect
> >> will not apply with this option when there is another wave track
> sync-locked
> >> with any one of the selected tracks.)
> >
> > I know not of this but I'll have a look if I get time
>
> Already done.  The search box is quite good in the Alpha Manual, so some of
> these are easy to check.
>
>
> >> Scrubbing, including toolbar and ruler popup menu items, and a new popup
> >> menu for the scrub bar
> >> Pinned play head, including a Transport menu item
> >
> > Well the Scuibbing and pinned head were documented a while ago, soon
> > after James declared the Scrub GUI to be frozen with no mor changes.
> >
> > They both feature prominently in the New Features page:
> > http://alphamanual.audacityteam.org/man/New_features_in_this_release
> >>
> >> Page up / down keys interchanged their effects
>
> Already done.
>
>
> > Don't know what you're referring to 0 shortcuts are all documented in the
> > shortcuts reference page:
> > http://alphamanual.audacityteam.org/man/Keyboard_Shortcut_Reference
>
>
>
> >>
> >> Esc key can abort dragging or resizing of toolbars
> >
> > I can add this if I get time (it is rather minor functionality though)
> >>
> >> Two-fingered horizontal swipe on Mac touchpad (and the second
> scrollwheel
> >> at the thumb, on fancy mice like MX Master) to change magnification to
> >> scroll the track
> >> Pinch and spread gestures on Mac touchpad
>
> I did not think the second scrollwheel at the thumb worked. How do you do
> do you a swipe on a wheel? Please explain exactly how it works.
>

Two-fingered horizontal swipe on the Mac touchpad scrolls the tracks left
and right.  This is the same as what shift+mousewheel (or shift + two
fingered vertical swipe) has long done.

And I verified that the same is also done with the thumb wheel of the
Logitech MX Master mouse, on MacOs.

I tried the MX Master on Windows 7 too, but it did not always work, and I
did not figure out why.  I have not tried it with Windows 10.

The thumb wheel need not be mentioned, but I think it is good to mention
the touch pad enhancement.

PRL


>
> > I have no idea where to document these MAc-specific gestures
>
> It is partially documented here:
> http://alphamanual.audacityteam.org/man/Mouse_Preferences
>
> I suggest continuing there.
>
>
> >> Tooltips for all toolbar buttons mention shortcut key if assigned
> >
> > Tooltipsdon't seem to be mentioned here - not sure I see the value od
> adding
> > this but I'll have a look:
> >
> >>
> >> More arrangements possible for docking of toolbars
> >
> > And these are?  This page alreeady talks about redocking, undocking &
> moving
> > (with examples)
> > http://alphamanual.audacityteam.org/man/Toolbars_Overview
> > What else would you have us add?
> >>
> >> Changed behavior of shift+ and ctrl+click in track control panel or in
> >> tracks, affecting the set of selected tracks; also works that way in
> Mixer
> >> board
> >
> > IIRC I think we fixed this but I'll check - Gale and I did a lot of work
> on
> > this recently.
>
> I added a P1 to mention on Mixer Board. We may or may not mention
> anchor tracks in the main content about this - at the moment we skirt
> round it.
>
>
> >> Edit... added to popup menu in label track
> >
> > I see no Edit entry in the Label Track dropdown menu  :-//
> >>
> >> Columns added to Label edit dialog for spectral selection
> >
> > I thought we did this - maybe you could check for us as this is your
> > functionality
> >>
> >> Added an incomplete, imitated "standard" Mac Window menu
> >
> > WE did some work on this and updated it - but I'll re-check
>
> I did this a while ago, as complete as the menu is. .
>
>
> >> Export of labels includes spectral selection
> >
> > http://alphamanual.audacityteam.org/man/File_Menu#export_labels
> > No mention of it here - and I'm not sure I want to complicate that page.
> > I think it would be better on one of the spectral pages
> >>
> >> Shift+click and drag inside label text behaves better (differently on
> Mac,
> >> following different conventions, as recommended by D. Bailes)
> >
> > No ide what this is about - perhaps you could clarify
> >>
> >> Interaction with VoiceOver on Mac
> >
> > I saw you had been workin on that.  I have no idea how to make it work
> and
> > thus
> > no idea how to document it - Maybe David Bailes could help out here?
>
> We are still stating 2.1.3 as inaccessible on Mac because of the difficulty
> or reading tracks (David's decision). So no work is needed.
>
> That said, when VoiceOver is fixed, a page outside the Manual like David's
> effort for JAWS:
> http://vip.chowo.co.uk/wp-content/uploads/jaws/Audacity-2.1.2-Guide.html
>
> would come in very handy.
>
>
> >> Rebinding of mouse wheel behaviors in vertical ruler:  partly Steve's
> >> work.
> >>
> >> Ctrl+wheel magnifies
> >> shift + wheel scrolls up and down
> >> in Waveform dB, shift + ctrl + wheel changes the bottom of the dB scale,
> >> in two different ways, either with changed magnification when the
> pointer is
> >> far from the bottom, or without, when not.  (Try it with a generated
> pluck.
> >> The slope of the decaying envelope is unchanging when "without
> >> magnification.")
> >
> > I'm pretty sure that these got documented - but I'll check
>
> I did that a while ago.
>
> >> The vexed History dialog changes, which we might revert.
>
> Still wants a review though given the meaning of Size has changed and
> is potentially confusing. That review is already on my list to do.
>
>
> Gale
>
> > James stated earlier today that the History Dialog GUI (with its
> > vicissitudes) will not be changed for 2.1.3
> >
> >>
> >> PRL
> >
> >
> >
> > We will soon be in Manual freeze so the time available for all of this
> is in
> > short supply.  We'll do what we can do, not all may make it in time ...
> >
> > Peter
> >>
> >>
> >>
> >>
> >> ------------------------------------------------------------
> ------------------
> >>
> >> _______________________________________________
> >> audacity-devel mailing list
> >> aud...@li...
> >> https://lists.sourceforge.net/lists/listinfo/audacity-devel
> >>
> >
> >
> > ------------------------------------------------------------
> ------------------
> >
> > _______________________________________________
> > audacity-devel mailing list
> > aud...@li...
> > https://lists.sourceforge.net/lists/listinfo/audacity-devel
> >
>
> ------------------------------------------------------------
> ------------------
> _______________________________________________
> audacity-devel mailing list
> aud...@li...
> https://lists.sourceforge.net/lists/listinfo/audacity-devel
>