[Intel-gfx] [maintainer-tools PATCH] dim.rst: Document aliases extension on dimrc.

Rodrigo Vivi rodrigo.vivi at intel.com
Fri Aug 18 23:44:12 UTC 2017


On my own workflow I was missing a way to download mboxes
directly from patchwork with the patchwork id. So my first
reflex was to modify dim to fulfil my needs. However that
was increasing dim in complexity and dependencies and leaving
that messy.

That was when Jani suggested me the dimrc extension with the
example that is now part of this spec.

That was clean and simple enough to understand, so Daniel
suggested me to add it to the spec.

For record let's put my final local solution that lays now on
my own ~/.dimrc

dim_pwaq()
{
	if [ -n "$1" ]; then
		curl https://patchwork.freedesktop.org/patch/$1/mbox/ | dim_apply_queued
	else
	echo "Give me a patchwork id"
	fi
}

v2: Use code-block directive. Get's cleaner and make check happy.

Cc: Jani Nikula <jani.nikula at intel.com>
Cc: Daniel Vetter <daniel.vetter at ffwll.ch>
Signed-off-by: Rodrigo Vivi <rodrigo.vivi at intel.com>
---
 dim.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/dim.rst b/dim.rst
index 802c776e03f9..d8c9d728dc7b 100644
--- a/dim.rst
+++ b/dim.rst
@@ -441,6 +441,24 @@ usage
 Short form usage help listing all subcommands. Run by default or if an unknown
 subcommand was passed on the cmdline.
 
+ALIASES
+=======
+
+Extending **dim** functionalities
+---------------------------------
+
+It is possible to create your own dim helper and aliases by adding them to \$HOME/.dimrc
+
+.. code-block:: bash
+
+		dim_my_fancy_list_aliases()
+		{
+			echo "Hello world!":
+			dim_list_aliases:
+		}
+
+		dim_alias_list_aliases=my-fancy-list-aliases
+
 ENVIRONMENT
 ===========
 
-- 
2.13.2



More information about the Intel-gfx mailing list