Documentation ¶
Overview ¶
cdc starts a custom version of cairo-dock with a new config GUI.
Usage:
cdc command [arguments]
The commands are:
appinfo appinfo edits applets information build build cairo-dock sources external external applets management remote remote controls the active dock upload upload files or text to one-click hosting services version print cdc version
Use "cdc help [command]" for more information about a command.
Without command, the dock will be started with those arguments:
Display Backend:
-c Use Cairo backend. -o Use OpenGL backend. -O Use OpenGL backend with indirect rendering. There are very few case where this option should be used. -A Ask again on startup which backend to use. -W Work around some bugs in Metacity Window-Manager (invisible dialogs or sub-docks)
Desktop:
-k Lock the dock so that any modification is impossible for users. -e env Force the dock to consider this environnement - use it with care. -a Keep the dock above other windows. -s Don't make the dock appear on all desktops.
Paths override:
-d path Use a custom config directory. Default: ~/.config/cairo-dock -S url Address of a server with additional themes (overrides default). -M path Ask the dock to load additionnal modules from this directory. (though it is unsafe for your dock to load unnofficial modules).
Debug:
-w time Wait for N seconds before starting; this is useful if you notice some problems when the dock starts with the session. -x appname Exclude applets from activating (still loaded). Separator=; -f Safe mode: don't load any plug-ins. -l level Log verbosity: debug,message,warning,critical,error (def=warning). -F Force to display some output messages with colors. -D Debug mode for the go part of the code (including applets). -N Don't start the internal Dbus service (used by remote command). -pf pprof file output: go tool pprof $(which cdc) /pathToFile -pw pprof web service: http://localhost:port/debug/pprof
Versions:
-v Print gldi version. -vv Print all versions.
This version still lacks some options and may not be considered usable for everybody at the moment. But it also needs to be tested now.
Appinfo edits applets information ¶
Usage:
cdc appinfo [-d path] appletname...
AppInfo edits applets registration information.
Common flags:
-d path Use a custom config directory. Default: ~/.config/cairo-dock
Build cairo-dock sources ¶
Usage:
cdc build [-k] [-r] [-h] target
Build builds and install Cairo-Dock sources.
Targets:
c or core Build the dock core. p or plug-ins Build all plug-ins. applet name Use the name of the applet directory in cairo-dock-plug-ins. Plug-ins must have been installed first.
Flags:
-k Keep build dir unchanged before build (no make clean). -r Reload your target after build. -h Hide the make install flood if any. -g Graphical mode. Use gksudo to request password.
Options:
-s Sources directory. Default is current dir. -j Specifies the number of jobs (commands) to run simultaneously. Default = all availables processors.
External applets management ¶
Usage:
cdc external [-d path] [-r] [appletname...]
External lists, installs or removes Cairo-Dock external applets.
The action depends if applet names are provided, and on the -r flag:
no applet name Display the list of external applets. one or more Install applet(s). one or more and -r Remove applet(s).
Common flags:
-d path Use a custom config directory. Default: ~/.config/cairo-dock
Remove flag:
-r Remove applets instead of install.
List matching flags:
-s Only match applets found on the applet server. -l Only match applets found locally.
List display flags:
-json Print applet package data in JSON format. -f template Set a specific format for the list, with the go template syntax.
You can use a template to format the result the way you want. For example, to have just the applet name: -f '{{.DisplayedName}}'. Everything is possible like '{{.DisplayedName}} by {{.Author}}'.
For the full list of fields, see AppletPackage:
http://godoc.org/github.com/sqp/godock/libs/packages#AppletPackage
Remote controls the active dock ¶
Usage:
cdc remote command [args...]
Remote sends a remote command to the active dock.
d Debug appletName [state] Set the debug state of a go applet. To disable the debug, use state: false, no or 0. All other state value will enable the debug for the applet. sb SourceCodeBuildTarget Build the current source code target. sg SourceCodeGrepTarget grepString Grep text in the current source code target dir. so SourceCodeOpenFile filePath Open a file in the current source code target dir (if relative). ul UpToShareLastLink Print the link of the last uploaded item.
Upload files or text to one-click hosting services ¶
Usage:
cdc upload path/to/file
Upload send data (file or pipe) to a one-click hosting service.
Flags:
-m Multiple files enabled.
Examples:
cdc upload /path/to/file cdc upload < path/to/file cat /path/to/file | cdc upload echo "test online text" | cdc upload # send raw text
Note: you must have an active instance of the NetActivity applet.
Print cdc version ¶
Usage:
cdc version
Version prints the cdc version.