Merge f40ce3c8f7 into 29e14c1aee

api.go

@@ -336,19 +336,9 @@ func hlmultiprompt(t *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 }
 
 // alias(cmd, orig)
-// Sets an alias, with a name of `cmd` to another command.
+// Sets an alias of `cmd` to `orig`
-// #param cmd string Name of the alias
+// --- @param cmd string
-// #param orig string Command that will be aliased
+// --- @param orig string
-/*
-#example
--- With this, "ga file" will turn into "git add file"
-hilbish.alias('ga', 'git add')
-
--- Numbered substitutions are supported here!
-hilbish.alias('dircount', 'ls %1 | wc -l')
--- "dircount ~" would count how many files are in ~ (home directory).
-#example
-*/
 func hlalias(t *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 	if err := c.CheckNArgs(2); err != nil {
 		return nil, err
@@ -368,20 +358,8 @@ func hlalias(t *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 }
 
 // appendPath(dir)
-// Appends the provided dir to the command path (`$PATH`)
+// Appends `dir` to $PATH
-// #param dir string|table Directory (or directories) to append to path
+// --- @param dir string|table
-/*
-#example
-hilbish.appendPath '~/go/bin'
--- Will add ~/go/bin to the command path.
-
--- Or do multiple:
-hilbush.appendPath {
-	'~/go/bin',
-	'~/.local/bin'
-}
-#example
-*/
 func hlappendPath(t *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 	if err := c.Check1Arg(); err != nil {
 		return nil, err

docs/api/_index.md

@@ -1,7 +1,7 @@
 ---
 title: API
 layout: doc
-weight: -100
+weight: -50
 menu: docs
 ---
 

docs/api/hilbish/_index.md

@@ -14,8 +14,8 @@ interfaces and functions which directly relate to shell functionality.
 ## Functions
 |||
 |----|----|
-|<a href="#alias">alias(cmd, orig)</a>|Sets an alias, with a name of `cmd` to another command.|
+|<a href="#alias">alias(cmd, orig)</a>|Sets an alias of `cmd` to `orig`|
-|<a href="#appendPath">appendPath(dir)</a>|Appends the provided dir to the command path (`$PATH`)|
+|<a href="#appendPath">appendPath(dir)</a>|Appends `dir` to $PATH|
 |<a href="#complete">complete(scope, cb)</a>|Registers a completion handler for `scope`.|
 |<a href="#cwd">cwd() -> string</a>|Returns the current directory of the shell|
 |<a href="#exec">exec(cmd)</a>|Replaces running hilbish with `cmd`|
@@ -54,25 +54,9 @@ hilbish.alias(cmd, orig)
 </a>
 </h4>
 
-Sets an alias, with a name of `cmd` to another command.  
+Sets an alias of `cmd` to `orig`  
-  
-  
 #### Parameters
-`string` **`cmd`**  
+This function has no parameters.  
-Name of the alias
-
-`string` **`orig`**  
-Command that will be aliased
-
-#### Example
-```lua
--- With this, "ga file" will turn into "git add file"
-hilbish.alias('ga', 'git add')
-
--- Numbered substitutions are supported here!
-hilbish.alias('dircount', 'ls %1 | wc -l')
--- "dircount ~" would count how many files are in ~ (home directory).
-````
 </div>
 
 <hr><div id='appendPath'>
@@ -83,24 +67,9 @@ hilbish.appendPath(dir)
 </a>
 </h4>
 
-Appends the provided dir to the command path (`$PATH`)  
+Appends `dir` to $PATH  
-  
-  
 #### Parameters
-`string|table` **`dir`**  
+This function has no parameters.  
-Directory (or directories) to append to path
-
-#### Example
-```lua
-hilbish.appendPath '~/go/bin'
--- Will add ~/go/bin to the command path.
-
--- Or do multiple:
-hilbush.appendPath {
-	'~/go/bin',
-	'~/.local/bin'
-}
-````
 </div>
 
 <hr><div id='complete'>

docs/completions.md

@@ -1,12 +1,3 @@
----
-title: Completions
-description: Tab completion for commands.
-layout: doc
-menu: 
-  docs:
-    parent: "Features"
----
-
 Hilbish has a pretty good completion system. It has a nice looking
 menu, with 2 types of menus: grid (like file completions) or
 list.

docs/jobs.md

@@ -1,12 +1,3 @@
----
-title: Jobs
-description: Controls for background commands in Hilbish.
-layout: doc
-menu: 
-  docs:
-    parent: "Features"
----
-
 Hilbish has pretty standard job control. It's missing one or two things,
 but works well. One thing which is different from other shells
 (besides Hilbish) itself is the API for jobs, and of course it's in Lua.

docs/lunacolors.md

@@ -1,10 +1,3 @@
----
-title: Lunacolors
-layout: doc
-weight: -60
-menu: docs
----
-
 Lunacolors is an ANSI color/styling library for Lua. It is included
 by default in standard Hilbish distributions to provide easy styling
 for things like prompts and text.

docs/nature/_index.md

@@ -1,10 +1,3 @@
----
-title: Nature
-layout: doc
-weight: -90
-menu: docs
----
-
 A bit after creation, we have the outside nature. Little plants, seeds,
 growing to their final phase: a full plant. A lot of Hilbish itself is
 written in Go, but there are parts made in Lua, being most builtins

docs/vim-mode/_index.md

@@ -1,10 +1,3 @@
----
-title: Vim Mode
-layout: doc
-weight: -90
-menu: docs
----
-
 Hilbish has a Vim binding input mode accessible for use.
 It can be enabled with the `hilbish.inputMode` function (check `doc hilbish`).
 

docs/vim-mode/actions.md

@@ -1,12 +1,3 @@
----
-title: Actions
-layout: doc
-weight: -80
-menu: 
-  docs:
-    parent: "Vim Mode"
----
-
 Vim actions are essentially just when a user uses a Vim keybind.
 Things like yanking and pasting are Vim actions.
 This is not an "offical Vim thing," just a Hilbish thing.

emmyLuaDocs/hilbish.lua

@@ -49,14 +49,13 @@ function hilbish.editor.getChar() end
 --- @param text string
 function hilbish.editor.setVimRegister(register, text) end
 
---- Sets an alias, with a name of `cmd` to another command.
+--- Sets an alias of `cmd` to `orig`
---- 
+--- @param cmd string
---- 
+--- @param orig string
 function hilbish.alias(cmd, orig) end
 
---- Appends the provided dir to the command path (`$PATH`)
+--- Appends `dir` to $PATH
---- 
+--- @param dir string|table
---- 
 function hilbish.appendPath(dir) end
 
 --- Registers a completion handler for `scope`.