docs: fix typos, cleanup wording (#12227)

pull/12233/head
czkz 2021-10-18 21:03:27 +03:00 committed by GitHub
parent 108644d260
commit a84a6d1fb1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 12 deletions

View File

@ -1312,7 +1312,7 @@ if mut x is MyStruct {
// same with match // same with match
match mut x { match mut x {
MyStruct { MyStruct {
// x is casted to MyStruct even it's mutable // x is casted to MyStruct even if it's mutable
// without the mut keyword that wouldn't work // without the mut keyword that wouldn't work
println(x) println(x)
} }
@ -2552,8 +2552,7 @@ Installed modules:
ui ui
``` ```
To see all the modules you have installed, you can use: To see all the modules that need updates:
outdated Show installed modules that need updates.
```powershell ```powershell
v outdated v outdated
``` ```
@ -2623,7 +2622,7 @@ Modules are up to date.
the module name you provided e.g. `mygithubname.mymodule`. the module name you provided e.g. `mygithubname.mymodule`.
**Optional:** tag your V module with `vlang` and `vlang-module` on github.com **Optional:** tag your V module with `vlang` and `vlang-module` on github.com
to allow a better search experiance. to allow for a better search experience.
## Type Declarations ## Type Declarations
@ -3536,7 +3535,7 @@ fn main() {
go fn (the_channel chan f64) { go fn (the_channel chan f64) {
_ := <-the_channel _ := <-the_channel
}(ch3) }(ch3)
//
select { select {
a := <-ch { a := <-ch {
// do something with `a` // do something with `a`
@ -3619,7 +3618,7 @@ using `rlock` for read-only and `lock` for read/write access.
```v ```v
struct St { struct St {
mut: mut:
x int // data to shared x int // data to be shared
} }
fn (shared b St) g() { fn (shared b St) g() {
@ -3776,7 +3775,7 @@ option to see more details about the individual tests run.
You can put additional test data, including .v source files in a folder, named You can put additional test data, including .v source files in a folder, named
`testdata`, right next to your _test.v files. V's test framework will *ignore* `testdata`, right next to your _test.v files. V's test framework will *ignore*
such folders, while scanning for tests to run. This is usefull, if you want to such folders, while scanning for tests to run. This is useful, if you want to
put .v files with invalid V source code, or other tests, including known put .v files with invalid V source code, or other tests, including known
failing ones, that should be run in a specific way/options by a parent _test.v failing ones, that should be run in a specific way/options by a parent _test.v
file. file.
@ -4230,7 +4229,7 @@ Comments spanning multiple lines are merged together using spaces, unless
- the line is empty - the line is empty
- the line ends with a `.` (end of sentence) - the line ends with a `.` (end of sentence)
- the line is contains purely of at least 3 of `-`, `=`, `_`, `*`, `~` (horizontal rule) - the line is purely of at least 3 of `-`, `=`, `_`, `*`, `~` (horizontal rule)
- the line starts with at least one `#` followed by a space (header) - the line starts with at least one `#` followed by a space (header)
- the line starts and ends with a `|` (table) - the line starts and ends with a `|` (table)
- the line starts with `- ` (list) - the line starts with `- ` (list)
@ -4675,7 +4674,7 @@ If no flags are passed it will add `--cflags` and `--libs`, both lines below do
The `.pc` files are looked up into a hardcoded list of default pkg-config paths, the user can add The `.pc` files are looked up into a hardcoded list of default pkg-config paths, the user can add
extra paths by using the `PKG_CONFIG_PATH` environment variable. Multiple modules can be passed. extra paths by using the `PKG_CONFIG_PATH` environment variable. Multiple modules can be passed.
To check the existance of a pkg-config use `$pkgconfig('pkg')` as a compile time if condition to To check the existance of a pkg-config use `$pkgconfig('pkg')` as a compile time "if" condition to
check if a pkg-config exists. If it exists the branch will be created. Use `$else` or `$else $if` check if a pkg-config exists. If it exists the branch will be created. Use `$else` or `$else $if`
to handle other cases. to handle other cases.
@ -4852,7 +4851,7 @@ use `v help`, `v help build` and `v help build-c`.
1. compile your binary with debugging info `v -g hello.v` 1. compile your binary with debugging info `v -g hello.v`
2. debug with [lldb](https://lldb.llvm.org) or [GDB](https://www.gnu.org/software/gdb/) e.g. `lldb hello` 2. debug with [lldb](https://lldb.llvm.org) or [GDB](https://www.gnu.org/software/gdb/) e.g. `lldb hello`
Troubleshooting (debugging) executables [created with V in GDB](https://github.com/vlang/v/wiki/Troubleshooting-(debugging)-executables-created-with-V-in-GDB) [Troubleshooting (debugging) executables created with V in GDB](https://github.com/vlang/v/wiki/Troubleshooting-(debugging)-executables-created-with-V-in-GDB)
**Visual debugging Setup:** **Visual debugging Setup:**
* [Visual Studio Code](vscode.md) * [Visual Studio Code](vscode.md)
@ -4864,7 +4863,7 @@ native backend (flag: `-b native`).
### Javascript Backend ### Javascript Backend
To debug the generated Javascript output you can active source maps: To debug the generated Javascript output you can activate source maps:
`v -b js -sourcemap hello.v -o hello.js` `v -b js -sourcemap hello.v -o hello.js`
For all supported options check the latest help: For all supported options check the latest help:
@ -5513,7 +5512,7 @@ fn C.my_external_function(voidptr, int, voidptr) int
// Calls to following function must be in unsafe{} blocks. // Calls to following function must be in unsafe{} blocks.
// Note that the code in the body of `risky_business()` will still be // Note that the code in the body of `risky_business()` will still be
// checked, unless you also wrap it in `unsafe {}` blocks. // checked, unless you also wrap it in `unsafe {}` blocks.
// This is usefull, when you want to have an `[unsafe]` function that // This is useful, when you want to have an `[unsafe]` function that
// has checks before/after a certain unsafe operation, that will still // has checks before/after a certain unsafe operation, that will still
// benefit from V's safety features. // benefit from V's safety features.
[unsafe] [unsafe]