From 5cdf979836e864839c5ac580c81fa66ca4c74121 Mon Sep 17 00:00:00 2001 From: sspanak Date: Wed, 7 Feb 2024 18:10:52 +0200 Subject: [PATCH] documentation update --- README.md | 36 ++++++++++++------- docs/dictionaries/roWordlistReadme.txt | 8 ++--- docs/dictionaries/ukWordlistReadme.txt | 7 ++-- docs/user-manual.md | 6 ++-- .../tt9/ime/modes/helpers/AutoTextCase.java | 1 + 5 files changed, 35 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index ee8f2063..5ffc89c3 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # Traditional T9 -TT9 is an IME (Input Method Editor) for Android devices with a hardware keypad. It supports predictive text typing in [multiple languages](assets/languages/definitions) and configurable hotkeys, bringing old school Nokia experience to modern Android devices. +TT9 is an IME (Input Method Editor) for Android devices with a hardware keypad. It supports predictive text typing in [multiple languages](languages/definitions) and configurable hotkeys, bringing old school Nokia experience to modern Android devices. This is a modernized version of the [original project](https://github.com/Clam-/TraditionalT9) by Clam-. @@ -10,29 +10,34 @@ This is a modernized version of the [original project](https://github.com/Clam-/ or get the APK from the [Releases Section](https://github.com/sspanak/tt9/releases/latest). ## Screenshots - - ## System Requirements -- Android 4.4 or higher. _(Tested and confirmed on Android 4.4.2, 10 and 11)_ -- Free space: - - Minimum 40 Mb when not using Predictive mode and no dictionaries are loaded. - - Plenty of space per each enabled language in Predictive mode (50-400 Mb, depending on the word count). +- Android 4.4 or higher. _(Tested and confirmed on Android 6.0, 10 and 11)_ - A hardware keypad or a keyboard. For touchscreen-only devices, an on-screen keypad can be enabled in the Settings. +- Minimum 50 Mb of storage space. Extra space is needed for language dictionaries in Predictive Mode. + - Very small languages (< 100k words; Yiddish, Indonesian): 5-6 Mb per language. + - Small languages (100k-400k words; e.g. English, Norwegian, Swedish, Finnish, German, French): 15-30 Mb per language. + - Medium languages (400k-800k words; e.g. Danish, Hebrew, Italian, Greek): 40-75 Mb per language + - Large languages (800k-1.5M words; e.g. Bulgarian, Spanish, Romanian, Ukrainian, Russian): 100-165 Mb per language -_If you own a phone with Android 2.2 up to 4.4, please refer to the original version of Traditional T9 from 2016._ +_Storage usage depends on the word roots count, and the average word length in each language. Some languages will require more space, even if they have less words than others._ -## How to use Traditional T9? +### Compatibility +If you own a phone with Android 2.2 up to 4.4, please refer to the original version of Traditional T9 from 2016. + +TT9 may not work well on Kyocera phones, some Sonim phones and some other devices that run highly customized Android versions, where all apps are integrated and intended to work with the respective native keyboard. You may experience missing functionality or unexpected text/numbers appearing when you try to type. + +## How to Use Traditional T9? Before using Traditional T9 for the first time you would need to load a dictionary and configure it. After that, you could start typing right away in one of the three modes: Predictive, ABC or Numeric (123). And even if you have mastered the keypad back in the days, you would still find the Predictive mode now provides powerful and smart new ways of typing with even less key presses. So make sure to read the initial setup and the hotkey tips in the [user manual](docs/user-manual.md). ## Contributing to the Project As with many other open-source projects, this one is also maintained by its author in his free time. Any help in making Traditional T9 better will be highly appreciated. Here is how: -- [Report bugs](https://github.com/sspanak/tt9/issues) or other unusual behavior on different phones. Currently, the only testing and development devices are: Qin F21 Pro+ / Android 11; Energizer H620SEU / Android 10. But Android behaviour and appearance varies a lot across the millions of devices available out there. -- Add [a new language](CONTRIBUTING.md#adding-a-new-language), [new UI translations](CONTRIBUTING.md#translating-the-ui) or simply fix a spelling mistake. The process is very simple and even with minimum technical knowledge, your skills as a native speaker will be of great use. Or, if you are not tech-savvy, just [open a new issue](https://github.com/sspanak/tt9/issues) and put the correct translations there. +- Add [a new language](CONTRIBUTING.md#adding-a-new-language), [new UI translations](CONTRIBUTING.md#translating-the-ui) or simply fix a spelling mistake. The process is very simple and even with minimum technical knowledge, your skills as a native speaker will be of great use. Or, if you are not tech-savvy, just [open a new issue](https://github.com/sspanak/tt9/issues) and put the correct translations or words there. Correcting misspelled words or adding new ones is the best you can do to help. Processing millions of words in multiple languages is a very difficult task for a single person. +- [Report bugs](https://github.com/sspanak/tt9/issues) or other unusual behavior on different phones. Currently, the only testing and development devices are: Qin F21 Pro+ / Android 11; Energizer H620SEU / Android 10; Vodaphone VFD 500 / Android 6.0. But Android behaviour and appearance varies a lot across the millions of devices available out there. - Experienced developers who are willing fix a bug, or maybe create a brand new feature, see the [Contribution Guide](CONTRIBUTING.md). Your PRs are welcome! @@ -46,5 +51,10 @@ If you like Traditional T9, buy me a beer. Donations are currently accepted on [ - [Silver foil photo created by rawpixel.com - www.freepik.com](https://www.freepik.com/photos/silver-foil) - "Negotiate" and "Vibrocentric" fonts are under [The Fontspring Desktop/Ebook Font End User License](docs/desktop-ebook-EULA-1.8.txt). -## Privacy Policy -Traditional T9 never sends any sort of "telemetry", "reports" or your personal details anywhere. It has no network connectivity capabilities. +## Privacy Policy and Philosophy +- No ads. +- No spying, no tracking, no telemetry or reports. No nothing! +- No network connectivity. +- It only does its job. +- Open-source, so you verify all the above yourself. +- Created with help from the entire community. \ No newline at end of file diff --git a/docs/dictionaries/roWordlistReadme.txt b/docs/dictionaries/roWordlistReadme.txt index 6adc5e3d..12b2763b 100644 --- a/docs/dictionaries/roWordlistReadme.txt +++ b/docs/dictionaries/roWordlistReadme.txt @@ -1,8 +1,8 @@ Romanian wordlist sources: - Dexonline Scrabble word list: https://dexonline.ro/scrabble (version 6.0) -- Android Opens Source Project: https://android.googlesource.com/platform/packages/inputmethods/LatinIME/ (Git commit: 2023-03-20 [fe0c000f40a5cb33c518cc7a12204b5810886c0e]) -- titoBouzout's hunspell dictionaries: https://github.com/titoBouzout/Dictionaries (Git commit: 24c64ba) - +- Android Opens Source Project: https://android.googlesource.com/platform/packages/inputmethods/LatinIME/ (Version: fe0c000f4 (2023-03-20)) +- Helium314 dictionaries for Android: https://codeberg.org/Helium314/aosp-dictionaries/src/branch/main/wordlists, (Version: 5ba80afbb (2024-01-17)) +- titoBouzout's hunspell dictionaries: https://github.com/titoBouzout/Dictionaries (Version: 24c64ba) ===== titoBouzout readme: @@ -43,4 +43,4 @@ Copyright Terms: Support: Please direct all your questions on http://groups.google.com/group/rospell mailing - list, or contact the packager directly. \ No newline at end of file + list, or contact the packager directly. diff --git a/docs/dictionaries/ukWordlistReadme.txt b/docs/dictionaries/ukWordlistReadme.txt index d23e3091..a60caa8c 100644 --- a/docs/dictionaries/ukWordlistReadme.txt +++ b/docs/dictionaries/ukWordlistReadme.txt @@ -16,6 +16,7 @@ Kostyantyn Moroz mailto: morozko@i.com.ua ==================== - Extra words and frequencies obtained from LatinIME dictionaries. - Link: https://android.googlesource.com/platform/packages/inputmethods/LatinIME - Git commit: 21 Dec 2023 [66093bf509ea92fa31d796326d5f30a8d9582ffe] \ No newline at end of file +Extra words and frequencies obtained from LatinIME dictionaries. +Source: https://android.googlesource.com/platform/packages/inputmethods/LatinIME +Version: 66093bf509ea92fa31d796326d5f30a8d9582ffe (2023-12-21) +License: https://android.googlesource.com/platform/packages/inputmethods/LatinIME/+/refs/heads/main/NOTICE diff --git a/docs/user-manual.md b/docs/user-manual.md index a5767d73..2d71f5a9 100644 --- a/docs/user-manual.md +++ b/docs/user-manual.md @@ -27,15 +27,15 @@ Once a dictionary is loaded, it will stay there until you use one of the "delete It also means that if you need to start using language X, you can safely disable all other languages, load only dictionary X (and save time!), then re-enable all languages you used before. -Have in mind reloading a dictionary will reset the suggestion popularity to the factory defaults _(your custom added words will not be affected)_. However, there should be nothing to worry about. For the most part, you will see little to no difference in the suggestion order, unless you oftenly use uncommon words. +Have in mind reloading a dictionary will reset the suggestion popularity to the factory defaults. However, there should be nothing to worry about. For the most part, you will see little to no difference in the suggestion order, unless you oftenly use uncommon words. #### Deleting a Dictionary -If you have stopped using languages X or Y, you could disable them and also use "Delete Unselected", to remove their dictionaries and free some memory. +If you have stopped using languages X or Y, you could disable them and also use "Delete Unselected", to remove their dictionaries and free some storage space. To delete everything, regardless of the selection, use "Delete All". -In all cases, deleting a dictionary removes both all factory and all custom added words. +In all cases, your custom added words will be preserved and restored once you reload the respective dictionary. ## Hotkeys diff --git a/src/io/github/sspanak/tt9/ime/modes/helpers/AutoTextCase.java b/src/io/github/sspanak/tt9/ime/modes/helpers/AutoTextCase.java index 60bfffbe..1ec18136 100644 --- a/src/io/github/sspanak/tt9/ime/modes/helpers/AutoTextCase.java +++ b/src/io/github/sspanak/tt9/ime/modes/helpers/AutoTextCase.java @@ -67,6 +67,7 @@ public class AutoTextCase { return InputMode.CASE_CAPITALIZE; } + // this is mostly for English "I" if (TextTools.isNextToWord(textBeforeCursor)) { return InputMode.CASE_LOWER; }