From Audacity Wiki
Revision as of 14:23, 27 October 2007 by James (talk | contribs) (changes following code updates.)
Jump to: navigation, search

Outside the program itself

This is for any documents included in source code but not part of the program wording. See Documentation Checklist for all other documentation requirements including issues that must be release noted if not fixed.

  • [RA] Update the Unix manual page  to distinguish between 1.3 and 1.2. In particular, remove reference to 1.3 importing multiple files from command line into the same Project, unless this ability is reinstated before release (See Aim to for details).


Edit hint: All HelpText.cpp changes have been made. Gale, feel free to delete these two comments once you've read them.

(Current) Lines:

"when you want to listen to your work in other computer programs you \"export\" it as an audio file such as \" "a WAV, AIFF or MP3. When burning to CD, you export as WAV or AIFF.\"

Minor quibble: Some portable CD players can play MP3 format CDs. It's unusual, and would just cause confusion, so we're using the text as above. -JC

"_("You can <a href=\"*URL*\">download</a> the help files and then access them from Audacity as you have just attempted, or you can click <a href=\"*URL*\">here</a> to read the help online.")"

The download page must also tell you where to install the help files! (In the data directory, under a new sub directory called 'Help') -JC


Audio I/O tab

Latency panel:

Ideally this needs a few helpful words, but there is little space. Is it essential we keep the panels of equal height? If it is, then how about adding after "milliseconds":

Audio to buffer: - "higher = more latency"

Latency correction: - "negative = backwards"

If we can make more space, then we could elaborate: "higher value = more latency but more reliable recording" ; "Applies when playing tracks whilst recording. Negative value shifts recording backwards." Of course this is a substitute until we have context-sensitive help. - GA

Not in favour. I don't see enough space for this. -JC

Batch tab

Current Text:

"When importing audio files, normalize all tracks in project"

Move this option into the "Audio Files". Also consider a change after 1.4 so that only one normalisation is done where you have a chain starting with that effect and "normalize" is turned on (this has been placed in "not aiming"). GA believes these are good moves and that "normalize all tracks" will be used when it is in an appropriate tab and clearer what it does.

Needs more discussion. -JC

Directories tab

Current text:

"Auto save interval [ ] minutes"

Suggested replacement:

If [MM] changes autosave to strict interval saving, as per aim-to, change 'interval' back to 'every'.

The coding change probably won't get done in time for 1.4.0 -JC

Audio Files tab

Move in from Batch tab:

"When importing audio files, normalize all tracks in project"

See discussion in Batch tab section. Needs more discussion. -JC

MP3 Export Library Location

Suggested additional text:

Significant numbers of users have reported difficulty finding the new location of file format export options. Whilst "when exporting tracks" needs to remain here instead of in the Export File dialogue where it should be, I suggest adding text explaining where the export options have gone to. I suggest this could go inside the "when exporting tracks" panel under the radio buttons, and say:

"Note: Export quality options for WAV, AIFF, MP3 and other formats can be chosen by clicking the Options button at time of export."

Needs discussion -JC

Interface tab

Current text:

"Present track number to accessibility aid"

Suggested replacement:

"Present track number as accessibility aid"

Is this a screen reader function, not anything that appears visually? Or what does this do and is there a better description we can make? - GA

Perhaps it is presenting the numbers to the accessibility aid? Leaving as is until clarified. -JC


  • Enable dragging of left and right selection edges added the word 'enable'.

  • MP3 Export Setup to MP3 Export Library Location which is what it is.

  • When exporting tracks to an audio file added emphasis, 'to an audio file'.

  • When saving a project... wording for dependencies and order of options changed.

  • When importing uncompressed audio files into Audacity to When importing uncompressed audio files

  • File Formats tab name changed to Audio Files

  • HelpText.cpp many wording changes, including fix to |<< and >>|.

  • Normalize on Load changed to When importing audio, normalize all tracks.

  • Innertext:Recording written and text on monitoring added

  • Innertext:Export written and three typos corrected.

  • Innertext:Editing written and title changed to 'Editing and Greyed out Menus'.

  • Save Changes? Dialogue with empty Project: changed from "\n\nSaved project will be empty!!\n\nTo save the tracks you previously\nhad, click cancel, restore the tracks\nusing undo, and then save." to "\n\nSaved project will be empty!!\n\nTo save the tracks that were previously\nopen, click Cancel, Edit > Undo until all your\ntracks are open, then File > Save Project."

  • Interface tab, Show/Hide: "Show Welcome Message at program start up" , was 'Splash Screen'.

  • Find Clipping: "Start and stop must be greater than 0", was 'positive and greater than zero'.

  • Dependencies dialogue: The former "Close" and "Skip" buttons now both read "Do not copy any audio".

  • Export Multiple progress dialogue: "Exporting the entire project as a WAV/AIFF file" or (for MP3) "exporting the entire file..." now changed to "Exporting entire project" with (filename) in the dialogue title and (format) above the progress bar.

  • Latency Shift Dialogue: In "I have brought it back to start at zero", "I have" has been replaced with "Audacity has".

  • Preferences: Interface tab: "Tracks &fit vertically zoomed" changed to "Automatically &fit tracks vertically zoomed"

  • "Audacious!" buttons -> "OK... Audacious!"

  • GUIPrefs.CPP:

- "&Select all audio, if none selected, on applying effect"

+ "&Select all audio in project, if none selected"

- "&Circular track keyboard navigation"

+ "\"Move track focus\" &cycles repeatedly through tracks"

- "&Quit Audacity upon closing last window"

+ "Any Close/Exit command completely &quits Audacity"

  • Import.CPP:

- " is an encrypted audio file, typically from an online music store. \nAudacity cannot open this type of file due to the encryption.\nYou need to convert it to a supported, unencrypted audio format."

+ " is an encrypted audio file. These typically are from an online music store. \nAudacity cannot open this type of file due to the encryption. \nTry recording the file into Audacity, or burn it to audio CD then \nextract the CD track to a supported audio format such as WAV or AIFF."

- " is an audio CD file. \nAudacity does not open this type of file.\nTry ripping it to a native audio format that Audacity can import."

+ " is an audio CD track. \nAudacity cannot open audio CDs directly. \nExtract (rip) the CD tracks to an audio format that \nAudacity can import, such as WAV or AIFF.");

Add "WAV or AIFF" references to Real, AAC and WMA:

- " is a RealPlayer media file. \nAudacity cannot open this..."

+ " is a RealPlayer media file. \nAudacity cannot open this proprietary format. \nYou need to convert it to a supported audio format, such as WAV or AIFF."

- " is an Advanced Audio Coding file. \nAudacity cannot open this..."

+ " is an Advanced Audio Coding file. \nAudacity cannot open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."

- " is a Windows Media Audio file. \nAudacity cannot open this..."

+ " is a Windows Media Audio file. \nAudacity cannot open this type of file due to patent restrictions. \nYou need to convert it to a supported audio format, such as WAV or AIFF."

  • Default temporary directory: changed from "/tmp/audacity1.2-%USERNAME" to AUDACITY_VERSION, AUDACITY_RELEASE string