Difference between revisions of "Wording"

From Audacity Wiki
Jump to: navigation, search
(move "remove exclusion of .mpa format" to Done)
(move file types messages to done as have been comitted)
Line 12: Line 12:
  
 
__TOC__
 
__TOC__
 
== Import.cpp ==
 
 
'''Current line 197 onwards:''' 
 
 
'''Add the following excluded file types''' for MIDI and niche (but increasingly popular) types as there is mostly little chance they will have the wrong extension, so should show an accurate error message.
 
 
{|
 
!Format/extension !! Error message
 
|-
 
|valign="top" width="30%" |MIDI files '''(.midi, .mid)''' 
 
|"\"%s\" is a MIDI file, not an audio file. \nAudacity cannot open this type of file for playing or editing, but you can \ndisplay it by clicking File > Import > MIDI."
 
|-
 
|valign="top"|Other notes-based formats '''(.kar, .mod, .rmi)'''
 
|"\"%s\" is a notes-based file, not an audio file. \nAudacity cannot open this type of file. \nTry converting it to an audio file such as WAV or AIFF and \nthen import it, or record it into Audacity."
 
|-
 
|valign="top"|Musepack files '''(.mp+, .mpc, .mpp)'''
 
|"\"%s\" is a Musepack audio file. \nAudacity cannot open this type of file. \nIf you think it might be an mp3 file, rename it to end with \".mp3\" \nand try importing it again. Otherwise you need to convert it to a supported audio \nformat, such as WAV or AIFF."
 
|-
 
|valign="top"|Wavpack files '''(.wv, .wvc)'''
 
|"\"%s\" is a Wavpack audio file. \nAudacity cannot open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
 
|-
 
|valign="top"|AC3 files '''(.ac3)'''
 
|"\"%s\" is a Dolby Digital audio file. \nAudacity cannot currently open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
 
|-
 
|valign="top"|Speex files  '''(.spx)'''
 
|"\"%s\" is an Ogg Speex audio file. \nAudacity cannot currently open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
 
|}
 
 
 
 
  
 
== Preferences ==
 
== Preferences ==
Line 85: Line 54:
  
  
==Done==
+
=Done=
 +
=== Import.cpp ===
 +
'''Current line 197 onwards:''' 
 +
 
 +
'''Add the following excluded file types''' for MIDI and niche (but increasingly popular) types as there is mostly little chance they will have the wrong extension, so should show an accurate error message.
 +
 
 +
{|
 +
!Format/extension !! Error message
 +
|-
 +
|valign="top" width="30%" |MIDI files '''(.midi, .mid)''' 
 +
|"\"%s\" is a MIDI file, not an audio file. \nAudacity cannot open this type of file for playing or editing, but you can \ndisplay it by clicking File > Import > MIDI."
 +
|-
 +
|valign="top"|Other notes-based formats '''(.kar, .mod, .rmi)'''
 +
|"\"%s\" is a notes-based file, not an audio file. \nAudacity cannot open this type of file. \nTry converting it to an audio file such as WAV or AIFF and \nthen import it, or record it into Audacity."
 +
|-
 +
|valign="top"|Musepack files '''(.mp+, .mpc, .mpp)'''
 +
|"\"%s\" is a Musepack audio file. \nAudacity cannot open this type of file. \nIf you think it might be an mp3 file, rename it to end with \".mp3\" \nand try importing it again. Otherwise you need to convert it to a supported audio \nformat, such as WAV or AIFF."
 +
|-
 +
|valign="top"|Wavpack files '''(.wv, .wvc)'''
 +
|"\"%s\" is a Wavpack audio file. \nAudacity cannot open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
 +
|-
 +
|valign="top"|AC3 files '''(.ac3)'''
 +
|"\"%s\" is a Dolby Digital audio file. \nAudacity cannot currently open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
 +
|-
 +
|valign="top"|Speex files  '''(.spx)'''
 +
|"\"%s\" is an Ogg Speex audio file. \nAudacity cannot currently open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
 +
|}
 +
 
 +
 
 
'''Current line 182:'''  
 
'''Current line 182:'''  
  

Revision as of 14:42, 30 December 2007


Other source code changes that may require changes in text in Audacity as a consequence do not belong here. That is, don't put a wording change here unless it is needed with the code as it is now. Changes to the GUI such as moving buttons or controls from one place to another don't belong here either because they are not just wording changes. Also, only changes to documents that are actually compiled into executable builds, such as HelpText.cpp, should be included here - all other changes go to Documentation Checklist.

I largely agree, though that does mean that (relatively trivial) wording changes (like that to the LAME download button arising from a LAME installer) would have to be done at the time by the person doing the coding, or otherwise leave them and move the item in to "Wording" after coding? - GA


Preferences

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



Import / Export tab

Current text:

"When importing audio, normalize all tracks in project"

Replacement:

"Normalize all tracks in project"


TrackPanel.cpp

Current text: "Draw currently only works with linear-view waveforms"

Suggested alternatives:

  • "To use Draw, change to Waveform view using the Track Drop-Down Menu"
  • "Draw currently works only with Waveform view"

i.e. "linear-view" is suggested as un-necessarily vague if you don't actually know what it means.


Done

Import.cpp

Current line 197 onwards:

Add the following excluded file types for MIDI and niche (but increasingly popular) types as there is mostly little chance they will have the wrong extension, so should show an accurate error message.

Format/extension Error message
MIDI files (.midi, .mid) "\"%s\" is a MIDI file, not an audio file. \nAudacity cannot open this type of file for playing or editing, but you can \ndisplay it by clicking File > Import > MIDI."
Other notes-based formats (.kar, .mod, .rmi) "\"%s\" is a notes-based file, not an audio file. \nAudacity cannot open this type of file. \nTry converting it to an audio file such as WAV or AIFF and \nthen import it, or record it into Audacity."
Musepack files (.mp+, .mpc, .mpp) "\"%s\" is a Musepack audio file. \nAudacity cannot open this type of file. \nIf you think it might be an mp3 file, rename it to end with \".mp3\" \nand try importing it again. Otherwise you need to convert it to a supported audio \nformat, such as WAV or AIFF."
Wavpack files (.wv, .wvc) "\"%s\" is a Wavpack audio file. \nAudacity cannot open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
AC3 files (.ac3) "\"%s\" is a Dolby Digital audio file. \nAudacity cannot currently open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."
Speex files (.spx) "\"%s\" is an Ogg Speex audio file. \nAudacity cannot currently open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."


Current line 182:

  • Import.cpp: Remove exclusion of .mpa format as it's a valid MPEG-1 format.
  • Interface tab: Change to "Closing last window quits Audacity" (similar, slightly shorter wording to that in 1.3.3)
  • ExportPCM.cpp: Options dialogue for "WAV, AIFF, and other uncompressed types" changed from "Specify PCM Options" to "Specify Uncompressed Options"
  • Generate Menu: change inconsistent wordings in Chirp, DTMF, Noise, Silence, Tone to "Duration:"
  • Project.cpp: change text when opening 1.x project to "This file was saved by Audacity (1.x.x), a much\nolder version. The format has changed.\nAudacity could corrupt the file in opening\nit, so you must back it up first.\n\nOpen this file now?"
  • Tracks menu > Resample: change to "New sample rate (Hz)"
  • Interface tab: change to "Display range minimum for 'waveform (dB)' view"
  • Autorecovery.cpp: change to "Confirm?" dialogue header and text "Are you sure you don't want to recover any projects? They can't be recovered later."
  • Both "OK...Audacious" buttons to "OK".
  • Project.cpp: change to "This file was saved by Audacity (1.2.6). You can open\nthe file with this version of Audacity, but if you save it with this version\nyou will no longer be able to open it in older versions.\n\nOpen this file now?"
  • HelpText.cpp: remove duplicated links and make "[burnCD|burn to a CD]]" a bullet
  • Credit to Chris Cannam on the "Audacity" tab of "About Audacity" for Vamp.
  • Interface tab: remove preference "Present track number to accessibility aid"
  • MP3 Export Library Location, added under "when exporting tracks" Note: Export quality options for WAV, AIFF, MP3 and other formats can be chosen by clicking the Options button at time of export.
  • Audio to buffer: (higher = more latency)
  • Latency correction: (negative = backwards)
  • If you want to burn your work to an audio CD for standalone CD players, you must first in HelpText.cpp
  • a WAV, AIFF or MP3. If burning to an audio CD for standalone CD players, you must export as WAV or AIFF. in Helptext.cpp.
  • 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