Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

2009 update #162

Merged
merged 56 commits into from
Oct 29, 2020
Merged
Changes from 1 commit
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
9c5152d
Mark important docs as high pri for localization.
miniksa Sep 23, 2020
bb48386
recategorize some of the pages so they're easier to group and underst…
miniksa Sep 23, 2020
5998e67
Fix title and main heading for the warning from open publishing about…
miniksa Sep 23, 2020
7a92954
Do some editing.
miniksa Sep 23, 2020
bed232c
Revert "Mark important docs as high pri for localization."
miniksa Sep 23, 2020
c9fd60e
Create not recommended template, create documents explaining it, try …
miniksa Sep 25, 2020
28a411e
shuffle around, add metadata blocks and first header.
miniksa Sep 25, 2020
aadc9da
tiny update to ownership
miniksa Sep 25, 2020
98f1f14
did I use the wrong slashes for the path.
miniksa Sep 25, 2020
5336993
Bannerize a ton of APIs that we want to see be disfavored versus virt…
miniksa Sep 25, 2020
245b7f0
drop md from links as they didn't resolve on docs build.
miniksa Sep 25, 2020
f22055d
Fix capitalization issue in TOC.
miniksa Sep 25, 2020
8f23152
bit more cleanup
miniksa Sep 30, 2020
6cef3bf
condense ugly table
miniksa Sep 30, 2020
670c837
Wide scope of updating, templatizing, cleaning up tables, etc.
miniksa Oct 5, 2020
6ca0e83
disrecommend writing to specific coordinate.
miniksa Oct 5, 2020
ef936f6
somehow missed these two.
miniksa Oct 5, 2020
0c1973b
more vt tips.
miniksa Oct 6, 2020
ef45b97
Draft classic vs vt.
miniksa Oct 6, 2020
857d2f4
ecosystem roadmap
miniksa Oct 6, 2020
62b8d6b
Products, ecosystem
miniksa Oct 6, 2020
8de0d67
timeline/roadmap, move definitions out.
miniksa Oct 6, 2020
e4c3e30
some cleanup and add links
miniksa Oct 6, 2020
dd186a1
Add to TOC here?
miniksa Oct 6, 2020
d919522
fix links
miniksa Oct 6, 2020
b0399d2
Try headerless table to see if it shows correctly on the website.
miniksa Oct 6, 2020
5bf81a4
dustin comments + a bunch of psuedo/pseudo fixes.
miniksa Oct 6, 2020
a38e503
try markdig grid table
miniksa Oct 7, 2020
fe8a8fb
Revert "try markdig grid table"
miniksa Oct 7, 2020
e90972f
Revert "Try headerless table to see if it shows correctly on the webs…
miniksa Oct 7, 2020
8583f05
A bunch more cleanup and tips.
miniksa Oct 7, 2020
fce0187
fix all tips I didn't finish earlier today.
miniksa Oct 7, 2020
f0ab174
typo
mattwojo Oct 7, 2020
e5c6e3a
two dustin nits
miniksa Oct 7, 2020
7cdbdcc
trickery
miniksa Oct 7, 2020
80deb7c
fix broken links
miniksa Oct 7, 2020
5c92ba2
bulk trickery
miniksa Oct 7, 2020
fdf3c75
try adjusting link paths to parent.
miniksa Oct 7, 2020
e144ace
try to fix last batch of warnings.
miniksa Oct 7, 2020
357a1b2
Minor reorg to improve framing intent
mattwojo Oct 8, 2020
5f2af55
Merge pull request #164 from MicrosoftDocs/2009-update-mw
mattwojo Oct 9, 2020
5ebc90e
Editorial review suggestions
mattwojo Oct 12, 2020
e92c71e
fix def anchor links
mattwojo Oct 12, 2020
bf7f39c
fix def links add file type
mattwojo Oct 12, 2020
aab79d3
typo
mattwojo Oct 13, 2020
667b013
minor grammatical updates
mattwojo Oct 13, 2020
9b0c645
Fix header
mattwojo Oct 13, 2020
109de60
typo
mattwojo Oct 13, 2020
223c943
Update format of bullet list
mattwojo Oct 13, 2020
ce92884
Update terminal explanation
mattwojo Oct 15, 2020
32f26d8
Merge pull request #166 from MicrosoftDocs/2009-update-mw
mattwojo Oct 15, 2020
a9d7f8a
Proposed rephrasing of UTF8/16 support.
miniksa Oct 28, 2020
f5a5cad
Merge branch '2009-update' of https://github.com/MicrosoftDocs/Consol…
miniksa Oct 28, 2020
52b8e3f
fix warning
miniksa Oct 28, 2020
94fd0df
Revisions for Dustin commentary.
miniksa Oct 28, 2020
12225b3
Link console api
mattwojo Oct 28, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions docs/classic-vs-vt.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,14 +51,16 @@ As Windows has evolved, the security controls and restrictions on window handles

### Unicode

The implicit standard for communication across platforms and the web is Unicode, specifically in the UTF-8 form. Of course, other encodings still exist. However, when otherwise undefined, using UTF-8 is widely accepted as the appropriate default. It represents the balance of portability, storage/transmission size, and breadth of expression required to support the world's languages and glyphs.
The implicit standard for communication across platforms and the web is Unicode, specifically in the UTF-8 form. Of course, other encodings still exist. However, when otherwise undefined, using UTF-8 is widely accepted as the appropriate default. It represents the balance of portability, storage/transmission size, and breadth of expression required to support the world's languages and glyphs. However, an algorithmic equivalent in UTF-16 was chosen as the primary Unicode support mechanism for the Windows platform.
miniksa marked this conversation as resolved.
Show resolved Hide resolved

The Windows console platform has supported and will continue to support all existing code pages and encodings, but we recommend UTF-8 for all forward looking development and also accept UTF-16 as an algorithmically-translatable alternative.

UTF-8 support in the console can be found via the _A_ variant of all Console APIs against console handles after setting the codepage to `65001` or `CP_UTF8` with the [**SetConsoleOutputCP**](setconsoleoutputcp.md) and [**SetConsoleCP**](setconsolecp.md) methods as appropriate. Setting the code pages in advance is only necessary if the machine has not chosen "Use Unicode UTF-8 for worldwide language support" in the settings for Non-Unicode applications in the Region section of the Control Panel.
The Windows console platform has supported and will continue to support all existing code pages and encodings. It is recommended to focus on UTF-16 for maximum compatibility across Windows versions and performing algorithmic translation with UTF-8 if necessary. Increased support of UTF-8 is in progress for the console system.
miniksa marked this conversation as resolved.
Show resolved Hide resolved

UTF-16 support in the console can be utilized with no additional configuration via the _W_ variant of all console APIs and is a more likely choice for applications already well versed in UTF-16 through communication with the `wchar_t` and _W_ variant of other Microsoft and Windows platform functions and products.

UTF-8 support in the console can be found via the _A_ variant of Console APIs against console handles after setting the codepage to `65001` or `CP_UTF8` with the [**SetConsoleOutputCP**](setconsoleoutputcp.md) and [**SetConsoleCP**](setconsolecp.md) methods as appropriate. Setting the code pages in advance is only necessary if the machine has not chosen "Use Unicode UTF-8 for worldwide language support" in the settings for Non-Unicode applications in the Region section of the Control Panel.
miniksa marked this conversation as resolved.
Show resolved Hide resolved

>[!NOTE] As of now, UTF-8 is supported fully on the standard output stream with the [**WriteConsole**](writeconsole.md) and [**WriteFile**](https://msdn.microsoft.com/library/windows/desktop/aa365747) methods. Support on the input stream varies depending on the input mode and will continue to improve over time. Notably the default **["cooked"](high-level-console-modes.md)** modes on input do not fully support UTF-8 yet. The current status of this work can be found at [**microsoft/terminal#7777**](https://github.com/microsoft/terminal/issues/7777) on GitHub. The workaround is to use the algorithmically-translatable UTF-16 for reading input through [**ReadConsoleW**](readconsole.md) or [**ReadConsoleInputW**](readconsoleinput.md) until the outstanding issues are resolved.

## Recommendations

For all new and ongoing development on Windows, virtual terminal sequences are recommended as the way of interacting with the terminal. This will converge Windows command-line client applications with the style of application programming on all other platforms.
Expand Down