Re: [Audacity-quality] LOF File Documentation

[Peter S. <pet...@gm...>]

The good news is that the various changes I made today in the Manual for
LOF files
will make it into the 3.0.2 released Manual - as we found another P1 bug
today - and
that forces us into a second Release Candidate RC02 (but only once we've
cracked
the bug).

Peter.

On Mon, Apr 12, 2021 at 1:44 PM Peter Sampson <
pet...@gm...> wrote:

> I also just added a LOF files entry to the front page to aid
> "discoverability"
>
> https://alphamanual.audacityteam.org/man/Main_Page#Help_with_Advanced_Topics
>
> Peter.
>
>
> On Mon, Apr 12, 2021 at 1:13 PM Peter Sampson <
> pet...@gm...> wrote:
>
>>
>>
>> On Mon, Apr 12, 2021 at 11:05 AM Peter Sampson <
>> pet...@gm...> wrote:
>>
>>>
>>>
>>> On Mon, Apr 12, 2021 at 10:54 AM Steve Fiddle <ste...@gm...>
>>> wrote:
>>>
>>>>
>>>>
>>>> On Mon, 12 Apr 2021 at 10:42, Peter Sampson <
>>>> pet...@gm...> wrote:
>>>>
>>>>>
>>>>>
>>>>> On Sun, Apr 11, 2021 at 10:24 PM John Colket <jc...@gm...>
>>>>> wrote:
>>>>>
>>>>>> A user has suggested the following:
>>>>>>
>>>>>>
>>>>>>    - "The LOF documentation page does not state how to use the LOF
>>>>>>    file. It's as simple as File > Open. But unless you stumble over that in
>>>>>>    the File menu documentation page before encountering the LOF documentation
>>>>>>    page, it remains a mystery. A reference to File > Open on the 'LOF Files'
>>>>>>    documentation page would be helpful."
>>>>>>
>>>>>> See https://forum.audacityteam.org/viewtopic.php?p=422533#p422533
>>>>>>
>>>>>
>>>>> Hi John I can do something along those lines - but I am somewhat
>>>>> confused.
>>>>>
>>>>> The LOF Files page
>>>>> https://alphamanual.audacityteam.org/man/LOF_Files
>>>>> states in its intro div:
>>>>>
>>>>> > A LOF file is a plain text file ending with the extension ".lof"
>>>>> that contains a list of audio files to import into an Audacity project
>>>>> window.
>>>>> Implying that it is File>Import rather than File>Open that is user to
>>>>> operate on LOF files
>>>>> This would be more sensible as LOF files are not native data format
>>>>> (only AUP3/AUP is that)
>>>>>
>>>>
>>>> Technically, LOF files are "Imported".
>>>> On import, Audacity parses the contents of the LOF files and imports
>>>> audio files that are listed in the LOF file.
>>>>
>>>> Practically, as with audio files, a LOF file may be "opened" (imported
>>>> into a new project).
>>>>
>>>>
>>>>>
>>>>> It also adds this bit that baffles me entirely
>>>>> >It can optionally contain commands to create new project windows.
>>>>>
>>>>
>>>> That feature appears to be broken, as is the "window offset" command.
>>>> From very brief testing (on Windows 10), the only part that appears to
>>>> work is importing the listed audio files.
>>>>
>>>
>>> So another can  o' worms
>>>
>>> Perhaps you could add a bug report please Steve.
>>>
>>
>> Thanks for that Steve.  I upgraded it to P2 due to the regression.
>> https://bugzilla.audacityteam.org/show_bug.cgi?id=2743
>>
>>
>>> And then I'll add a pro tem note div to the LOF Files page saying that
>>> the Window command doesn't work
>>> which would get removed if and when the bug gets fixed
>>>
>>
>> I added an alert div on the LOF files page
>> https://alphamanual.audacityteam.org/man/LOF_Files#Command_syntax
>>
>> Which can be removed if and when the bug gets fixed
>>
>> Peter.
>>
>>
>>
>>>
>>>
>>>>
>>>> The specific problem being reported on the forum is that the
>>>> documentation states that on windows, the path separator must be a double
>>>> backslash. With Audacity 3.0.0, double backslash fails (file not found).
>>>> The path separator for Audacity 3.0.0 on Windows should be a single
>>>> backslash.
>>>>
>>>
>>> On the LOF Files page example I see single backslash being used
>>> https://alphamanual.audacityteam.org/man/LOF_Files
>>> So where is the reference to double backslash?
>>>
>>> The other problem they raise and that John highlighted at the start of
>>> this thread
>>> was that they struggled to find out about LOF files - I'm minded to
>>> agree so I'll try
>>> to find some time to tidy this up and clarify it in the Manual.
>>>
>>> Peter.
>>>
>>>
>>>
>>>> Steve
>>>>
>>>>
>>>>
>>>>>
>>>>> And this page implies that it is Import that is to be used to hanfle
>>>>> LOF files:
>>>>>
>>>>> https://alphamanual.audacityteam.org/man/Import_Filtering_and_Importer_Order
>>>>>
>>>>>
>>>>> However having said that about Import I do not other places in te
>>>>> Manual that refer
>>>>> to Open in the context of LOF files:
>>>>> https://alphamanual.audacityteam.org/man/File_Menu#open
>>>>>
>>>>>
>>>>> Ahh a bit more reading shows this page makes it a liitle clearer
>>>>> https://alphamanual.audacityteam.org/man/Importing_Audio#filetypes
>>>>>
>>>>>
>>>>> It appears that one can use File>Import or File>Open to act on on LOF
>>>>> files
>>>>> I can intuit what the Import does - pulls all the files in the list
>>>>> into the existing open active project.
>>>>> I'm not sure how it works with File>Open
>>>>> a) does it open a new project and import all the files in that list
>>>>> into the new project, or
>>>>> b) open a new project for each file in the list, or
>>>>> c) something else?
>>>>>
>>>>> I may need to experiment.
>>>>>
>>>>> Peter.
>>>>>
>>>>>
>>>>>
>>>>>> - John
>>>>>> _______________________________________________
>>>>>> Audacity-quality mailing list
>>>>>> Aud...@li...
>>>>>> https://lists.sourceforge.net/lists/listinfo/audacity-quality
>>>>>>
>>>>> _______________________________________________
>>>>> Audacity-quality mailing list
>>>>> Aud...@li...
>>>>> https://lists.sourceforge.net/lists/listinfo/audacity-quality
>>>>>
>>>> _______________________________________________
>>>> Audacity-quality mailing list
>>>> Aud...@li...
>>>> https://lists.sourceforge.net/lists/listinfo/audacity-quality
>>>>
>>>