Argument names for autocompletion in Kile

Question

Let say I created the following command in my latex document

\newcommand{\red}[1]{
  \textcolor{red}{#1}
}

When working with the LaTeX editor Kile, the autocompletion gives me something like

\red{x} %[Proposed by Kile (autocompletion)] 

But instead of 'x', I would like Kile propose to me something like

\red{text} %[Proposed by Kile (autocompletion)]

That could be useful when I have to deal with commands requiring a bunch of arguments. For instance, if I created a command using \newcommand requiring 8 arguments, the autocompletion of kile will propose to me something like :

\mycommand{x}{x}{x}{x}{x}{x}{x}{x} %[Proposed by Kile (autocompletion)]

...but after some times, you do not know who is who! So it would be nice to define 'argument names' so that the autocompletion propose to me something like :

\mycommand{date}{name}{stuff1}{stuff2}{age}{address}{city}{whateveritis} %[Proposed by Kile (autocompletion)]

To summarize, I would like to change this :

to this :

Answer 1

This can be achieved by creating a custom auto completion file. Such a file has the extension cwl and (on my systom) has to be saved under ~/.kde4/share/apps/kile/completion/tex. The # is a comment char in such a file. In such a file you write the commands with the text you want to appear in the arguments.

# custom auto-completion file
#

\mycommand{date}{name}{stuff1}{stuff2}{age}{address}{city}{whateveritis}

After a restart of kile it can be activated through Settings -> Configure Kile -> Kile/Complete -> Add (or similar, it's German on my system).

After that it works like a standard auto completion: