Commit Graph

52 Commits

Author SHA1 Message Date
Paul Licameli 3c50935484 A type distinction for strings that are URLs, and some Doxygen 2021-07-01 13:02:26 -04:00
Paul Licameli c5ebc396eb Audacity.h has shrunk to nothing, now remove it! 2021-05-10 00:05:23 -05:00
Paul Licameli e653b4aaf8 Eliminate Experimental.h, configure compile options instead...
... This makes it impossible to forget to include the EXPERIMENTAL definitions
(such as when cutting and pasting code) and so get unintended quiet changes of
behavior.

The EXPERIMENTAL flags are now specified instead in new file Experimental.cmake
2021-04-27 12:40:07 -04:00
Paul Licameli fa4d35296e AllThemeResources.h has a .cpp & doesnt include Theme.h...
... (it used to, via MacroMagic)

This splits a cycle of 8 into 6 + 1 + 1
2020-05-28 05:50:24 -04:00
Paul Licameli 61abb87a77 Reviewed all i18n-hint comments...
... Moved many misplaced ones, which msgfmt would not have extracted into
audacity.pot.

Duplicated some of them, to appear with related but distinct msgids.

Added a few new comments.

Deleted one that was no longer needed in ProjectManager.cpp.
2020-04-05 09:00:00 -04:00
Paul Licameli d96471f176 Rewrite composition of long texts in HelpText.cpp 2019-12-26 22:11:33 -05:00
Paul Licameli e3ea93a624 Define and use function Verbatim...
... in cases of "TranslatableString" that are not really translated.

This makes it easier to scan the code for such unusual constructions of
TranslatableString, distinct from mere mentions of the TranslatableString type.
2019-12-19 22:49:23 -05:00
Paul Licameli 53ee9c9800 TranslatableString for titles, names, labels of wxDialogWrappers...
... Found one missed translation in CommandTargets.cpp
2019-12-16 10:58:05 -05:00
James Crook 80ef424338 Bug 169 - Welcome Message: Local links to "Quick Help" and "Manual" do nothing if help is not installed. 2019-08-20 22:29:18 +01:00
Paul Licameli 56b1d531b2 HelpText.cpp has fewer dependencies...
... freeing it to a low level and AboutDialog.cpp to a high level, by moving
functions from the latter into the former
2019-05-18 20:29:25 -04:00
Paul Licameli 6c57948d8f Remove unnecessary #include-s from .cpp files...
... Unnecessary because transitively included.

But each .cpp file still includes its own .h file near the top to ensure
that it compiles indenendently, even if it is reincluded transitively later.
2019-05-16 17:21:00 -04:00
Paul Licameli f45300f032 This is only comments, in files where USE_ macros are tested...
... following the comment convention used in the preceding commit.
2019-03-22 12:38:30 -04:00
Paul Licameli 5e7d41ec07 Each .cpp/.mm file includes corresponding header before any other...
... except Audacity.h

This forces us to make each header contain all forward declarations or nested
headers that it requires, rather than depend on context.
2019-03-17 22:54:52 -04:00
Paul Licameli 906e55f047 Experimental.h in all .h or .cpp files that directly use EXPERIMENTALs...
... except Audacity.h; and in no others.

Do so even if Experimental.h gets multiply included, as in both the .h and
.cpp files.

This makes it easier to do a text scan to be sure there are no unintended quiet
changes of meaning because of omission of Experimental.h when the flag is
an enabled one.

Also move inclusions of Experimental.h earlier.

Also don't require Experimental.h to be preceded by Audacity.h to define
EXPERIMENTAL_MIDI_OUT correctly.
2019-03-17 22:54:00 -04:00
Paul Licameli 173a300427 Include nothing before Audacity.h, as comments say we should...
... and remove some duplicated inclusions
2019-03-17 21:41:39 -04:00
Paul Licameli 2db49dc1f0 Use standard library style members of wxArrayString (and wxString) ...
... which will make it easier to change the types of those containers to
std::vectors of other string-like classes

for wxString,

IsEmpty => empty
Clear => clear
Alloc => reserve

for wxArrayString,

Count => size
GetCount => size
IsEmpty => empty
Add => push_back
Clear => clear
Empty => clear
Sort => std::sort (only with default comparator)
SetCount => resize
Last => back
Item => operator []
Alloc => reserve
2019-03-10 14:43:57 -04:00
Olivier Humbert 052f5d355d Update HelpText.cpp 2018-08-29 23:07:37 -04:00
James Crook 8991fe7521 Fix incorrect https and translation markings.
- DarkAudacity website does not support https, so don't specify https in strings.
- Don't translate text about DarkAudacity.
2018-02-26 14:09:07 +00:00
Paul Licameli 586542bfe2 Remove post-translation substitutions 2018-02-21 19:20:54 -05:00
Paul Licameli 007fa9eca2 http -> https in user-visible strings...
... Some in wxT can be edited directly, some in _() are not really used now
so they can be edited directly, others require a post-translation substitution.

Not all links to libraries from Credits work with https: so update only those
that do.
2018-02-05 08:52:13 -05:00
Paul Licameli c6696f1b49 Move definition of _ and related into Internat.h 2018-01-06 21:03:32 -05:00
Paul Licameli 9612e3d971 indentation, final newlines, spelling, remove unused members 2017-11-05 21:01:38 -05:00
Paul Licameli d7d7d67f7c Edit one link destination inside an internationalized string...
... Apply substituion to the result of translation lookup, assuming the
translator preserved the url verbatim.  (But in future, we should not have
urls inside translated strings.)

Problem is that the page faq_opening_and_saving_files.html will exist in the
2.2.0 manual online, but the anchor #midi will no longer exist on it.

This help link comes up only when import fails (perhaps the file is corrupt)
and the user presses the help button.

This help goes through an unusual code path that never uses local help.  That
could stand fixing in future.
2017-10-19 16:34:35 -04:00
Paul Licameli 954a974422 Changed the conditional compilation for alpha/beta/release...
... In particular, don't put the extra information in MIDI device info for Beta

But still link to the Alpha manual.
2017-09-11 00:10:22 -04:00
Paul Licameli 5d4ddbc424 Make the (en) welcome window say it's a Beta test version, not alpha...
... This gets in too late for the translation files, but very few of them
included a translation for this message.  So, it will appear English for all.
2017-09-01 21:44:44 -04:00
James Crook ce9938787c Use alpha or released or local manual for "help on selection".
Previously this was hard coded to use the online alphamanual.
Some other help-on-errors paths were hardcoded to use the online manual, and did not use local help even if available, so these were changed too.

Also two naming changes in the code:
ShowHelpDialog() became ShowHelp() because it typically shows the help in your browser, only showing the help in a dialog under certain circumstances.
The helpURL parameter became helpPage since it is usually a page name that is then elaborated into a url.
The Link() function became InnerLink().

Some careful http -> https changes made too.
2017-08-25 13:59:16 +01:00
Paul Licameli 33d9a130c8 Correct wiki to HTML translation of https: links...
... so that if such are in the Credits dialog, they work correctly and don't
cause wxWidgets assertions
2017-08-23 12:49:12 -04:00
James Crook 028ed19d90 Sync with DarkAudacity 2017-04-02 23:07:13 +01:00
James Crook a5f7dc60c4 Alpha welcome screen help hyperlinks to alpha manual. 2017-03-02 16:33:19 +00:00
James Crook fc42fd9b0d Bug 1597 - Tweak: make version check on welcome user-initiated.
The welcome screen now has an extra prelude for Alphas, and as result no longer needs to force a version check onto our website.  Users can still do that by clicking "check online".

I've also rearranged the version check code a little, so that there is better reuse.  E.g. we can change the URL in just one place in the code.
2017-02-28 19:05:06 +00:00
James Crook 8b9fab8ff5 Fix line continuation on Linux. 2016-09-11 13:47:53 +01:00
James Crook 545d741eb2 Make Audacity source more like DarkAudacity source. 2016-09-11 13:03:37 +01:00
James Crook 923eefaf90 Add code from merging.
This brings more of the code from DarkAudacity into Audacity, though not yet enabled.  This will make cherry picking later easier.
- Changing colour of html displays now possible, as colour links are visible for substitution.  (Can't use css as wxHTML is very limited).
- Export can now be preset to a particular format independent of preferences.
- SnapTo reversion on zoom now a DA controlled option.
- Caching of pinning preference for faster repaint because preferences are slow.
- Record Append now has sensible limit on number of tracks, rather than giving an error, and flipping the meaning of shift is now DA controlled.
2016-09-10 21:34:14 +01:00
James Crook 1184cd54fe Capitalise 'Manual'
(pointed out by Peter).
2016-08-19 22:07:49 +01:00
James Crook b1526fbdc8 Change strings for clarity/consistency.
Changes suggested by (translator) scootergrisen
2016-08-19 19:30:21 +01:00
James Crook 6b4a43a0a7 Fix some web addresses which changed with the manual moving. 2016-08-19 19:20:05 +01:00
Gale Andrews 8cb8e59046 Remove line breaks now help window is smaller 2016-08-09 17:55:03 +01:00
Gale Andrews 8166c01b81 Changes agreed on -quality list
* Move version string above "How to get help"
* Better English for bullet text
* Move Wiki below bullet list
2016-05-01 13:42:00 +01:00
Gale Andrews cad576c85c Use period at the end of a sentence that is text.
Or we could move the version number above the text so that it does not need a period.
2016-04-19 00:52:16 +01:00
James Crook 54ac17c086 Bug 1380 - "!" after "Welcome to Audacity" + VERSION_STRING
Discussion on -quality pointed out that (1) in alphas the '!' is emphasising the year, 2016, rather than the 'Welcome', that (2) in release the '!' can easily be misread as a 1 and so part of the version number (3) the topic is "How to Get Help", rather than the welcome (4) too many !!!!'s are OMG!!! culture (5) we already have an "!" in the title.
2016-04-18 11:35:21 +01:00
james.k.crook@gmail.com 5b65647b3b 'Manual' with capital M when referring to OUR Manual. 2014-10-11 12:04:44 +00:00
RichardAsh1981@gmail.com 50ff40e440 Expand wording of this message to explain how to change behaviour permanently. Patch from Steve which has been waiting a while 2014-09-30 19:38:39 +00:00
RichardAsh1981@gmail.com 3f49828d37 Standardise on working oof Recording and Playback rather than Input and Output throughout Audacity. Remove some very old junks strings at the same time. 2014-07-21 21:37:53 +00:00
RichardAsh1981@gmail.com ca7977f92e remove single-use code which is replaced by generic code in HelpSystem.cpp 2014-06-25 10:12:25 +00:00
benjamin.drung@gmail.com 277932dccb Remove trailing spaces. 2014-06-03 20:30:19 +00:00
RichardAsh1981@gmail.com 28e9f0ca73 make many functions which do not require access to class member variables static so they can be called without an object to do so with. Based on part of a patch by Campbell Barton 2013-09-21 19:15:42 +00:00
v.audacity e8714acce7 Gale's patch for [Audacity-quality] "Help buttons in dialogues WAS Re: Nyquist Generate Prompt" thread 2013-05-19 00:22:26 +00:00
james.k.crook@gmail.com cd54a2728b Fixed some smart quotes that can cause problems for .po file generation. 2012-03-20 21:59:30 +00:00
james.k.crook@gmail.com 69476e785c Fixed more internationalisation hints. 2012-03-20 15:36:02 +00:00
windinthew 0cc868a6aa Help text for Other Supported Formats 2011-07-29 08:34:04 +00:00