WikEmacs - User contributions [en]

Ncl

2013-12-29T05:53:20Z

Kindahero:

{{Package
|name=ncl-mode
|description=ncl-mode for editing NCL files.
|maintainer=Yagnesh
|source=http://github.com/yyr/ncl-mode
|in_emacs=no
|Development status=active
|website=http://github.com/yyr/ncl-mode
}}

'''NCL''' (NCAR Command Language) is a popular language in the field of Earth science. It processes and displays scientific data efficiently.
.

==ncl-mode==

'''NOTE:''' There are two version of ncl.el. One is the
[http://www.ncl.ucar.edu/Applications/Files/ncl.el official ]
version by NCL folks which contains only ncl.el. The forked version
contains few fixes to ncl.el and and ncl-doc el and other goodies to
be used by other Emacs packages

=== Basic Setup ===
To activate ncl-mode automatically for all files with an
[[file extension | extension ]] ".ncl" add add the following your [[.emacs]]

<syntaxhighlight lang="lisp">
(setq auto-mode-alist (cons '("\.ncl$" . ncl-mode) auto-mode-alist))
(autoload 'ncl-mode "~/bin/ncl.el")
</syntaxhighlight>

==ncl-doc-mode ==
[[File:Ncl-doc-usage.png|300px|thumb|right|screen shot shows the ncl-doc-mode in actions]]
'''ncl-doc''' minor mode helps you read NCL documentation from UCAR website

=== Basic Setup===
to start ncl-doc-mode for each ncl buffer add the following your [[.emacs]]
<syntaxhighlight lang="lisp">

(require 'ncl-doc)
(add-hook 'ncl-mode-hook
(lambda ()
(ncl-doc-minor-mode 1)))

</syntaxhighlight>

=== Usage ===
; {{CommandKeys|C-c C-s| ncl-doc-query-at-point}}
:This function does few things.
::1) It prompts for a string/keyword and collects a given string
::2) It tries to find a URL for the given string
::: + if it finds URL for the string call the browser to open that URL
::: + If no URL is found, then goes on to search for the given string.
::: + Displays all search matches in separate buffer category wise. In that buffer RET in any search match will call browser for take you to that page.
::: + If no matches found for a given string it leaves you there

; {{CommandKeys|C-c C-o| ncl-doc-query-open}}
: Use this function you lets you choose from the all keywords ncl-doc has in its database and takes you to that page.

[[Category:Programming languages]][[Category:Sciences]]

Ncl

2013-12-29T05:50:48Z

Kindahero:

{{Package
|name=ncl.el
|description=ncl-mode for editing NCL files.
|maintainer= ncl folks (forked version by Yagnesh)
|source=http://github.com/yyr/ncl.el
|in_emacs=no
|Development status=active
|website=http://github.com/yyr/ncl-mode
}}

'''NCL''' (NCAR Command Language) is a popular language in the field of Earth science. It processes and displays scientific data efficiently.
.

==ncl-mode==

'''NOTE:''' There are two version of ncl.el. One is the
[http://www.ncl.ucar.edu/Applications/Files/ncl.el official ]
version by NCL folks which contains only ncl.el. The forked version
contains few fixes to ncl.el and and ncl-doc el and other goodies to
be used by other Emacs packages

=== Basic Setup ===
To activate ncl-mode automatically for all files with an
[[file extension | extension ]] ".ncl" add add the following your [[.emacs]]

<syntaxhighlight lang="lisp">
(setq auto-mode-alist (cons '("\.ncl$" . ncl-mode) auto-mode-alist))
(autoload 'ncl-mode "~/bin/ncl.el")
</syntaxhighlight>

==ncl-doc-mode ==
[[File:Ncl-doc-usage.png|300px|thumb|right|screen shot shows the ncl-doc-mode in actions]]
'''ncl-doc''' minor mode helps you read NCL documentation from UCAR website

=== Basic Setup===
to start ncl-doc-mode for each ncl buffer add the following your [[.emacs]]
<syntaxhighlight lang="lisp">

(require 'ncl-doc)
(add-hook 'ncl-mode-hook
(lambda ()
(ncl-doc-minor-mode 1)))

</syntaxhighlight>

=== Usage ===
; {{CommandKeys|C-c C-s| ncl-doc-query-at-point}}
:This function does few things.
::1) It prompts for a string/keyword and collects a given string
::2) It tries to find a URL for the given string
::: + if it finds URL for the string call the browser to open that URL
::: + If no URL is found, then goes on to search for the given string.
::: + Displays all search matches in separate buffer category wise. In that buffer RET in any search match will call browser for take you to that page.
::: + If no matches found for a given string it leaves you there

; {{CommandKeys|C-c C-o| ncl-doc-query-open}}
: Use this function you lets you choose from the all keywords ncl-doc has in its database and takes you to that page.

[[Category:Programming languages]][[Category:Sciences]]

Main Page

2012-06-11T15:07:02Z

Kindahero:

'''WikEmacs''' (pronounced wiki-macs) collects useful resources for working with [[GNU Emacs]]. Think of it as a
'''next generation, better structured and improved [http://www.emacswiki.org/ Emacs Wiki]''' .
[[File:Emacs_parts.png|320px|thumb|right|Basic terminology of typical Emacs GUI Frame]]

---------
'''First time visitors''' can start [[#Explore WikEmacs | exploring WikEmacs]]. We have added lots of useful pages since the launch of WikEmacs. We want to keep you excited and engaged.

-----------
We need more '''[[:Category:WikEmacs Contributor|WikEmacs Contributor]]s'''. You can help the following way.

{{Note| First of all, please take a minute to look at the
[[WikEmacs:Guidelines]] before you start editing.}}

* Priority tasks
** Migrate content from [http://www.emacswiki.org EmacsWiki]. Please adopt the following approach -''I found this on EmacsWiki which was helpful. But it took me a lot of time to find it. Now that I have found it, I will put it in WikEmacs so that others can benefit from it.''

* Intermediate tasks
** Provide tutorials or content for the [[:Category:Popular Package|Popular Packages]] or [[:Category:Built-in Package|Built-in Packages]].
** Add more content to [[Special:ShortPages]]
** Document or add more [[:Category:Third Party Package|Third Party Package]]s

* Other tasks
** Copy edit [[Special:RecentChanges]] or be a moral police
** Add more members to various [[Special:Categories]]
** Categorize one of these pages [[Special:UncategorizedPages]]

----
'''Emacs News'''

The latest stable release of Emacs is [[GNU Emacs 24|Emacs-24]].

Emacs is available on all popular [[:Category:Install Or Upgrade| Operating Systems]] including [[Installing Emacs on GNU/Linux | GNU/Linux]], [[Installing Emacs on BSD |BSD]], [[Installing Emacs on OS X | OS X]] and [[Installing Emacs on Windows| Windows]]. It supports a variety of [[:Category:Programming languages|programming languages]].

= Explore WikEmacs =

To explore WikEmacs proceed as follows:
* Search for or visit a page of interest
* At the end of the page, there is a list of categories
* Click on individual categories and it will give you a list of all pages that will be of interest to you.

== What is your comfort level with Emacs? ==
* [[:Category:Beginner|Beginner]]
* [[:Category:Intermediate|Intermediate]]
* [[:Category:Expert|Expert]]
** Are you a maintainer of a [[:Category:Built-in Package|Built-in Package]]? If you don't find information about your package, please add it. No one else is better than you are to write about it.
** Have you developed any [[:Category:Third Party Package|Third Party Package]]s? Consider writing about what it is and how to use it.
* [[:Category:Vim User|Vim User]]
* [[:Category:User Level|Other]]

== What do you want to accomplish now? ==
* [[:Category:Install Or Upgrade|Install Or Upgrade]]
* [[:Category:Customization|Customize Emacs]]
* [[Key Bindings|Tweak Key Bindings]]
* [[:Category:Tutorial|Learn more Emacs (Tutorials)]]

== What do you use Emacs for? ==
* [[:Category:Text Editing|Text Editing]]
* [[:Category:Programming|Programming]]
* [[:Category:Document authoring|Document authoring]]
* [[:Category:Organizer|Getting Organized]]
* [[:Category:Email|Emailing]]
* [[:Category:Chat|Chatting]]
* [[:Category:Blogging|Blogging]]
* [[:Category:Browse|Browsing]]
* [[:Category:Workflow|Other]]

== How do you involve yourself with the community? ==
* [[:Category:Emacs User]]
* [[:Category:Emacs Contributor]]
* [[:Category:WikEmacs Contributor]]
* [[:Category:User Role|Other]]

[[Category:WikEmacs]]

Main Page

2012-06-11T08:12:28Z

Kindahero:

'''WikEmacs''' (pronounced wiki-macs) collects useful resources for working with [[GNU Emacs]]. Think of it as a
'''next generation, better structured and improved [http://www.emacswiki.org/ Emacs Wiki]''' .
[[File:Emacs_parts.png|320px|thumb|right|Basic terminology of typical Emacs GUI Frame]]

---------
'''First time visitors''' can start [[#Explore WikEmacs | exploring WikEmacs]]. We have added lots of useful pages since the launch of WikEmacs. We want to keep you excited and engaged.

-----------
We need more '''[[:Category:WikEmacs Contributor|WikEmacs Contributor]]s'''. You can help the following way.

{{Note| First of all, please take a minute to look at the
[[WikEmacs:Guidelines]] before you start editing.}}

* Priority tasks
** Migrate content from [http://www.emacswiki.org EmacsWiki]. Please adopt the following approach -''I found this on EmacsWiki which was helpful. But it took me a lot of time to find it. Now that I have found it, I will put it in WikEmacs so that others can benefit from it.''

* Intermediate tasks
** Provide tutorials or content for the [[:Category:Popular Package|Popular Packages]] or [[:Category:Built-in Package|Built-in Packages]].
** Add more content to [[Special:ShortPages]]
** Document or add more [[:Category:Third Party Package|Third Party Package]]s

* Other tasks
** Copy edit [[Special:RecentChanges]] or be a moral police
** Add more members to various [[Special:Categories]]
** Categorize one of these pages [[Special:UncategorizedPages]]

----
'''Emacs News'''

The latest stable release of Emacs is [[GNU Emacs 24.1|Emacs-24]].

Emacs is available on all popular [[:Category:Install Or Upgrade| Operating Systems]] including [[Installing Emacs on GNU/Linux | GNU/Linux]], [[Installing Emacs on BSD |BSD]], [[Installing Emacs on OS X | OS X]] and [[Installing Emacs on Windows| Windows]]. It supports a variety of [[:Category:Programming languages|programming languages]].

= Explore WikEmacs =

To explore WikEmacs proceed as follows:
* Search for or visit a page of interest
* At the end of the page, there is a list of categories
* Click on individual categories and it will give you a list of all pages that will be of interest to you.

== What is your comfort level with Emacs? ==
* [[:Category:Beginner|Beginner]]
* [[:Category:Intermediate|Intermediate]]
* [[:Category:Expert|Expert]]
** Are you a maintainer of a [[:Category:Built-in Package|Built-in Package]]? If you don't find information about your package, please add it. No one else is better than you are to write about it.
** Have you developed any [[:Category:Third Party Package|Third Party Package]]s? Consider writing about what it is and how to use it.
* [[:Category:Vim User|Vim User]]
* [[:Category:User Level|Other]]

== What do you want to accomplish now? ==
* [[:Category:Install Or Upgrade|Install Or Upgrade]]
* [[:Category:Customization|Customize Emacs]]
* [[Key Bindings|Tweak Key Bindings]]
* [[:Category:Tutorial|Learn more Emacs (Tutorials)]]

== What do you use Emacs for? ==
* [[:Category:Text Editing|Text Editing]]
* [[:Category:Programming|Programming]]
* [[:Category:Document authoring|Document authoring]]
* [[:Category:Organizer|Getting Organized]]
* [[:Category:Email|Emailing]]
* [[:Category:Chat|Chatting]]
* [[:Category:Blogging|Blogging]]
* [[:Category:Browse|Browsing]]
* [[:Category:Workflow|Other]]

== How do you involve yourself with the community? ==
* [[:Category:Emacs User]]
* [[:Category:Emacs Contributor]]
* [[:Category:WikEmacs Contributor]]
* [[:Category:User Role|Other]]

[[Category:WikEmacs]]

User talk:Kindahero

2012-05-03T06:18:20Z

Kindahero:

Any comments/critics/suggestions regarding my actions on this site are heartly welcome. [[User:Kindahero|Kindahero]] 22:08, 29 March 2012 (EEST)

Hi, the picture regarding Emacs' buffers/windows... there is one thing missing: fringes. They are not missing in the picture, but you forgot to mention them. There is even one with a 'wrapped' arrow. Thanks, dotemacs

: I will update soon.. tanks [[User:Kindahero|Kindahero]] 09:18, 3 May 2012 (EEST)

Talk:Quick Tutorial

2012-04-20T18:25:25Z

Kindahero:

This page is getting really Nice. It would be good if we have more internal links to other pages. So people reading this page will have a chance to read/learn more about individual features [[User:Kindahero]] 17:05, 20 April 2012 (EEST)
: I was thinking exactly the same thing :-) [[User:Bozhidar|Bozhidar]]

Talk:Quick Tutorial

2012-04-20T18:23:50Z

Kindahero:

This page is getting really Nice. It would be good if we have more internal links to other pages. So people reading this page will have a chance to read/learn more about individual features [[kindahero]] 17:05, 20 April 2012 (EEST)
: I was thinking exactly the same thing :-) [[User:Bozhidar|Bozhidar]]

Gnus

2012-04-08T18:27:39Z

Kindahero: syntaxhighlight

{{Package
|name=Gnus
|description=Gnus is an e-mail client, a news client and a feed aggregator.
|maintainer=[[Lars Magne Ingebrigtsen]]
|source=http://git.gnus.org/cgit/gnus.git/
|in_emacs=yes
|Development status=active
|website=http://gnus.org
}}

== Gnus with ''virtual servers'' ==
Gnus has unified interface to e-mail, feed, news, and others. ''virtual server'' are created for different source of information, and Gnus talks to this ''virtual server'' as if they are the same.

So, when someone want Gnus to work with particular source of information, he register a vertural server to Gnus as a ''select methods'', for example:

=== Using Gnus with Gmail ===
# Make sure gnutls-bin or starttls package is installed on your system
# Create a Gmail account
# Enable IMAP in Gmail accout, by settings->forwarding POP/IMAP
# Use Gmail’s IMAP as a (secondary) select method, by add following line into ./gnus.el

<syntaxhighlight lang="lisp">
(add-to-list 'gnus-secondary-select-methods '(nnimap "gmail"
(nnimap-address "imap.gmail.com")
(nnimap-server-port 993)
(nnimap-stream ssl)))
</syntaxhighlight>

or Using Gmail as primary select method

<syntaxhighlight lang="lisp">
(setq gnus-select-method '(nnimap "gmail"
(nnimap-address "imap.gmail.com")
(nnimap-server-port 993)
(nnimap-stream ssl)))
</syntaxhighlight>

5. Put following line in your ~/.authinfo 
machine imap.gmail.com login username@gmail.com password secret port 993 
6. (optional) Enable using gmail’s SMTP server by put following line in ./gnus.el

<syntaxhighlight lang="lisp">
(setq message-send-mail-function 'smtpmail-send-it
smtpmail-starttls-credentials '(("smtp.gmail.com" 587 nil nil))
smtpmail-auth-credentials '(("smtp.gmail.com" 587 "username@gmail.com" nil))
smtpmail-default-smtp-server "smtp.gmail.com"
smtpmail-smtp-server "smtp.gmail.com"
smtpmail-smtp-service 587
smtpmail-local-domain "yourcompany.com")
</syntaxhighlight>

=== Using Gnus with Gmane ===
you can easily read news from Gmane with Gnus
# in group buffer , press B (browser foreign server)
# type "nntp" when asked "which back end"
# type web.gmane.org when asked "address"
# browse different groups, press u to subscribe
For managing your address book, see [[:Category:Contact Management|Contact Management]].

[[Category:Email]][[Category:News (NNTP)]] [[Category:Mail Client]][[Category:Built-in Package]][[Category:Popular Package]]

User talk:Kanzeon

2012-04-06T17:08:32Z

Kindahero: Created page with "Welcome to WikEmacs -- ~~~~"

Welcome to WikEmacs -- [[User:Kindahero|Kindahero]] 20:08, 6 April 2012 (EEST)

Quick Tutorial

2012-04-06T13:10:07Z

Kindahero: templates keys, still need lot of them,( Note to the author: Please feel free to revert this)

This reference-like tutorial is aimed at Emacs beginners and probably others too. If you know how to do some basic editing and navigation in Emacs and want to quickly go through more of its capabilities, then this tutorial is for you. If you are looking for the semantics or key-bindings of a specific feature, this tutorial aims to be for you since it is a subset of the online Emacs documentation. If you are giving an introductory presentation about Emacs, this tutorial might help you.

The repository for the contents of this tutorial can be found here: [https://github.com/fredmorcos/emacs-reference https://github.com/fredmorcos/emacs-reference]

== Description and History ==

* Emacs is an extensible, customizable, self-documenting, real-time display text editor.
* Originally, a set of editing macros for the TECO editor.
* GNU Emacs was developed by R. Stallman and G. Steele.
* Technically, GNU Emacs is an elisp interpreter with text editing extensions.
* GNU Emacs contains thousands of commands and allows the user to combine them into elisp procedures (called macros) to automate work.
* Commands are, themselves, elisp procedures and the GNU Emacs configuration '''init''' file is an elisp program.

== Technical Description ==

; Extensible : The user can define, un-define and redefine commands as well as re-use available commands into macros.
; Customizable : The user can change properties of emacs elements including the key-bindings and the display.
; Self-documenting : All defined commands and macros get automatic preliminary documentation (bound keys and parameters).

== Why Emacs? ==

* Easily programmable
* Kill ring
* Rectangular editing
* Registers
* Command repetition
* Macros and Lisp procedures
* Modes
* Init file
* Remote files
* Shell, Terminal Emulator, IRC, Email, News, File Manager, Process Manager, Project Manager, Tetris, Doctor and many others.

== Terminology and Structure ==

; Buffer : A container for data (text, completions)
; Point : The current position in the buffer (cursor)
; Window : A visual container for a buffer
; Frame : A visual container for one or more windows
; Kill : The equivalent of cutting
; Yank : The equivalent of copying
; Kill Ring : A circular clipboard (very handy)
; Mark : The coordinates of a selection
; Region : The text inside a mark
; Modeline : A status line
; Minibuffer : A small buffer for commands and arguments
; Mode : The current type of data being edited

== Modeline ==

The Modeline is used to report different pieces of information.

<pre>-cs:ch-fr buf pos line (major minor)-----</pre>

; cs : Character set (or coding system)
; : : Newline mode
; ch : File modification status
; - or @ : File is local or remote
; fr : Frame name on text terminals
; buf : Buffer/file name
; pos : Point/cursor position
; line : Current line and column number
; modes (major minor) : Currently loaded major and minor modes

== Keybind Terms and Minibuffer ==

Emacs has some different naming of command/control keys (probably coming from the old days).

; M : Meta key, Alt or ESC
; C : Control key
; S : Shift key
; {{Keys|M-a}} : Press '''a''' while holding the meta key
; {{Keys|C-M-a}} : Press '''a''' while holding the control and meta keys
; {{Keys|C-a b}} : Press '''a''' while holding the control key then press '''b'''
; {{Keys|C-a C-b}} : Press '''a''' and '''b''' both while holding the control key
; {{Keys|C-a M-b}} : Press '''a''' with control then '''b''' with meta

The Minibuffer is used to input commands, arguments and setting different modes (which some of are bound to keys or menu actions).

; {{Keys|M-x}} : Execute a command by name

== Basic Usage ==

=== Loading ===

; <pre>$ emacs # opens Emacs at the scratch buffer</pre>
; <pre>$ emacs [file1] [file2] ... # opens Emacs in split-window mode</pre>
; {{Keys|C-x C-f}} ''filename'' : loads a new buffer from ''filename''

=== Saving ===

; {{Keys|C-x C-s}} : saves the current buffer
; {{Keys|C-x C-w}} ''filename'' : saves the current buffer as ''filename''

=== Other ===

; {{Keys|C-x C-c}} : quits emacs
; {{Keys|C-g C-g}} : cancels key-sequence

== Windows ==

Windows are used to display buffer contents. Windows can be split and resized inside an Emacs frame. The minibuffer has its own window.

* {{Keys|C-x 2}} : open a window vertically
* {{Keys|C-x 3}} : open a window horizontally
* {{Keys|C-x 0}} : close the current window
* {{Keys|C-x 1}} : close all other windows
* ESC ESC ESC : close all other windows
* {{Keys|C-x o}} : move to another window
* {{Keys|C-x ^}} : increase window size vertically
* {{Keys|C-x }}} : increase window size horizontally
* {{Keys|C-x {}} : decrease window size horizontally
* C-x <math>-</math> : shrink window to buffer size
* C-x <math>+</math> : make all windows equal in size

== Navigation & Movement ==

Word

* C-<math>\shortleftarrow</math> : moves one word backwards
* C-<math>\shortrightarrow</math> : moves one word forward

Line

* {{Keys|C-a}} : goes to beginning of the line (Home)
* {{Keys|C-e}} : goes to end of the line (End)
* {{Keys|M-a}} : goes to beginning of the sentence
* {{Keys|M-e}} : goes to end of the sentence
* {{Keys|M-g g}} : goes to given line by number

Paragraph

* C-<math>\shortuparrow</math> : moves up one paragraph
* C-<math>\shortdownarrow</math> : moves down one paragraph

Buffer

* {{Keys|C-x [}} : moves to the beginning of the buffer
* {{Keys|C-x ]}} : moves to the end of the buffer
* C-l : moves the buffer to position point
* {{Keys|C-x b}} : switches to another buffer by name
* C-x : switches to previous or next buffer
* {{Keys|C-x k}} : kills the current buffer

== Editing ==

Character

* {{Keys|C-d}} : deletes next character
* {{Keys|C-t}} : transposes current character with previous one
* C-q TAB : inserts a TAB verbatim

Word

* {{Keys|M-d}} : kills the next word
* {{Keys|M-- M-d}} : kills to the previous word
* {{Keys|M-/}} : expands current word
* M-/ SPC M-/expands current word and grabs next one
* {{Keys|M-C-/}} : completes current word
* {{Keys|M-t}} : transposes current word with next one
* {{Keys|M-- M-t}} : transposes current word with previous one
* {{Keys|M-c}} : capitalizes next word
* {{Keys|M-- M-c}} : capitalizes previous word
* {{Keys|M-l}} : lowercase next word
* {{Keys|M-- M-l}} : lowercase previous word
* {{Keys|M-u}} : uppercase next word
* {{Keys|M-- M-u}} uppercase previous word

Line

* {{Keys|M-o M-s}} : center a line
* C-S-BACKSPC : kills current line
* {{Keys|C-k}} : kills from point to EOL
* {{Keys|M-u C-k}} : kills to the previous line
* {{Keys|C-a C-k}} : goes to BOL then kills to EOL
* TAB : indents line depending on current mode
* {{Keys|C-o}} : breaks line before/after point
* {{Keys|C-x C-t}} : transpose current line with previous one
* {{Keys|M-0 C-x}} C-t : transpose current line with one at mark
* delete-matching-lines : delete lines matching a regexp

== Prefix Arguments & Command Repetition ==

Passing numerical arguments to commands can alter their behavior (e.g., repetition or inversion). Passing an argument can be done before M-x or key bindings.

* M-''n'' ''com''run ''com'' with prefix arg ''n''
* {{Keys|M--}} ''com''run ''com'' with negative prefix arg
* {{Keys|C-u}} ''n'' ''com''run ''com'' with prefix arg ''n''
* {{Keys|C-u}} ''com''run ''com'' with prefix arg 4
* {{Keys|C-u C-u}} ''com''run ''com'' with prefix arg 8
* {{Keys|C-u}} also terminates the prefix argument
* C-x [z]+repeats the previous <math>z^{th}</math> command with args
* C-x ESC ESCrepeats last command that uses the minibuffer

Examples:

* C-u 5 0 C-kwill kill 50 lines
* C-u 5 C-u 0will insert 5 zeros

== Search & Replace ==

Incremental search

* {{Keys|C-s}} <math>keyword</math>search forward
* {{Keys|C-r}} <math>keyword</math>search backward

Non-incremental search

* C-s RET <math>keyword</math>search forward
* C-r RET <math>keyword</math>search backward

Regular Expression Search

* {{Keys|C-M-s}} <math>expression</math>search regexp forward
* {{Keys|C-M-r}} <math>expression</math>search regexp backward

Notes:

* ESC will cancel and go to original point. RET will end at the current point.
* Searches are case-insensitive unless an uppercase letter is found in the search string.
* While searching, {{Keys|C-w}} will increment the search term with the current word.

Unconditional Replace

* replace-stringreplaces a string with another
* replace-regexpreplaces a regexp match with a string

Query Replace (Conditional Replace)

* {{Keys|M-%}} conditional replace of a string
* query-replace-regexpconditional replace of a regexp

Notes:

* Replaces are case-insensitive unless an uppercase letter is found in the match string.
* Replaces work from position to end of buffer unless a mark is active.
* After a replace, the position will be at the end of the last match. C-u C-SPC to go back to the position before the replace started.
* During a query replace, SPC will apply a replace and DEL will skip.

== Undo & Redo ==

In Emacs, there is no special redo function. Instead, there is only an undo function and redo can be achieved by undo-ing an undo.

* {{Keys|C-/}} undo a single change
* {{Keys|C-g}} break the chain of undos

Notes:

* If a mark is active, undo will only affect the marked region.

== Regions ==

Emacs uses the mark and point to denote a region (i.e., a selection).

* C-SPC creates a region (marks area)
* {{Keys|C-x C-x}} swaps mark and point in a region
* {{Keys|C-u C-x C-x}} swaps mark and point without region
* {{Keys|C-x h}} marks the entire document
* {{Keys|M-h}} marks the paragraph around
* TABindents the current region
* {{Keys|M-@}} incrementally mark next word

Kill, Yank and Paste Regions

* {{Keys|C-w}} kills the currently selected region
* {{Keys|M-w}} copies the currently selected region
* {{Keys|C-y}} ({{Keys|M-y}})*yanks and cycles from the kill ring

Notes:

* Yank is the copy command in vi and the paste command in emacs.

== Rectangles ==

Rectangles are marked regions between the columns of the point and mark. Applying operations on rectangles is some sort of vertical editing.

* {{Keys|C-x r k}} kill the rectangle
* {{Keys|C-x r d}} delete the rectangle
* {{Keys|C-x r y}} yank the last killed rectangle
* {{Keys|C-x r o}} push text to fill rectangle with spaces (open)
* {{Keys|C-x r c}} replace rectangle text with spaces (clear)
* {{Keys|C-x r t}} replace each line in rectangle with text

== Registers ==

Registers are places where you can store anything: text, position, rectangle, configuration, filename, ... Registers are named: ''a'', ''A'' and ''3'' are three different registers.

* view-registerview the contents of a register
* {{Keys|C-x r S}} PC ''r''record current point position in register ''r''
* {{Keys|C-x r j}} ''r''jump to position in register ''r''
* {{Keys|C-x r s}} ''r''save region to register ''r''
* C-u C-x r s ''r''kill region to register ''r''
* {{Keys|C-x r i}} ''r''insert text from register ''r''
* append-to-registerappend region to register
* prepend-to-registerprepend region to register
* {{Keys|C-x r r}} ''r''save rectangle into register ''r''

== Bookmarks ==

Bookmarks are like registers but persistent. They can also be named.

* {{Keys|C-x r m}} ''foo''bookmark file and point to ''foo''
* {{Keys|C-x r b}} ''foo''jump to bookmark called ''foo''
* {{Keys|C-x r l}} list all bookmarks
* bookmark-savesave all bookmarks
* bookmark-deletedelete a bookmark

== Macros ==

Macros are user defined commands using the Emacs command language. A user can “record” and “replay” a macro, useful for simple repeatable tasks. More complex tasks (e.g., conditions, loops) must be implemented in elisp. Macros are recorded in a macro ring.

* F3start macro definition or insert counter
* {{Keys|C-x (}} start macro definition only
* F4end macro definition or call macro
* {{Keys|C-x e}} end macro definition and call macro
* {{Keys|C-x )}} end macro definition only
* C-u C-u F3 append commands to last macro
* {{Keys|C-u F3}} re-run last macro then append commands to it
* {{Keys|C-x C-k r}} run macro on region
* {{Keys|C-x C-k C-n}} rotate to select the next macro in the ring
* {{Keys|C-x C-k C-p}} rotate to select the previous macro in the ring

Every macro definition can have a counter to insert into the buffer.

* F3inside a macro definition, inserts the counter
* {{Keys|C-x C-k C-i}} outside a macro definition, inserts the counter
* {{Keys|C-x C-k C-c}} set the macro counter value
* {{Keys|C-x C-k C-f}} set the macro counter format

Macros can be named and saved.

* {{Keys|C-x C-k n}} name the most recently defined macro
* {{Keys|C-x C-k b}} keybind the most recently defined macro
* insert-kbd-macroinsert macro into buffer as elisp code

Notes:

* It is best to use the reserved key bindings {{Keys|C-x C-k}} [a-zA-Z0-9] as to not cause problems with other bindings. {{Keys|C-x C-k}} b 4 will define {{Keys|C-x C-k}} 4 as a binding.

== Alignment ==

Emacs contains alignment commands. Sometimes those depend on the current mode (i.e., the language).

* alignaligns depending on mode
* align-regexpaligns using a regular expression
* {{Keys|C-u}} align-regexpaligns using a regular expression helper
* align-currentaligns current paragraph depending on mode

== Sorting ==

When sorting, prefixing with {{Keys|C-u}} sorts in descending order.

* sort-linessort region by lines
* sort-paragraphssort region by paragraphs
* {{Keys|C-u}} ''n'' sort-fieldssort lines in region by <math>\textit{\underline{n}}^{th}</math> field
* {{Keys|C-u}} -''n'' sort-fieldssort lines in region by <math>\textit{\underline{n}}^{th}</math> field from right
* sort-numeric-fieldsinterpret field as number and not text
* sort-columnssort by column specified by marked region
* reverse-regionreverses current region

== Tables ==

Emacs has support for creating and editing text-based tables by keeping track of their properties (e.g., position, size) in the buffer. When a buffer is saved to file, those properties are lost.

* table-insertinteractively insert a table into buffer
* table-recognizedetect properties of all tables in the buffer
* table-unrecognizeremove special table properties
* table-recognize-regiondetect properties of tables in region
* table-unrecognize-regionforget properties of tables in region
* table-recognize-tabledetect properties of table at point
* table-unrecognize-tableremove properties of table at point

Cell resizing:

* C-u ''n'' C-widen cell at point by ''n'' characters
* C-u ''n'' C-narrow cell at point by ''n'' characters
* C-u ''n'' C-}heighten cell at point by ''n'' lines
* C-u ''n'' C-{shorten cell at point by ''n'' lines

Cell movement:

* TABmove to cell on right
* S-TABmove to cell on left

Cell merging/splitting:

* {{Keys|C-c C-c}} *interactively merge two cells
* C-split cell horizontally
* C--split cell vertically

Rows & Columns:

* C-u ''n'' table-insert-rowinsert ''n'' rows
* C-u ''n'' table-delete-rowdelete ''n'' rows
* C-u ''n'' table-insert-columninsert ''n'' columns
* C-u ''n'' table-delete-columndelete ''n'' columns

Other:

* C-:interactively justify cell, column or row text
* C-!toggle table fixed width mode
* table-generate-sourcetable code in Latex, HTML or Cals

== Goodies ==

* C-x TABforce an indentation on a region
* {{Keys|M-q}} indents and breaks paragraph into multiple lines
* {{Keys|M-;}} comments a region or adds comment to line
* {{Keys|M-(}} inserts a new lisp function (parenthesis)
* {{Keys|M-)}} checks balanced parenthesis and opens line
* {{Keys|C-x}} iinserts file contents at point position
* {{Keys|M-!}} run shell command
* C-u M-!run shell command and insert output
* M-<math>|</math>run shell command on marked region
* C-u M-<math>|</math>run shell command on and replace marked region
* insert-bufferinserts buffer contents at point position
* copy-to-buffercopy region content to a buffer
* kill-some-buffersinteractively kill buffers
* electric-buffer-listinteractive buffer list
* toggle-truncate-linesdo not split lines over visual lines
* visual-line-modesplit lines by words
* viper-modevi compatibility

== Setting Key Bindings ==

Emacs has a global keymap which maps between keys and commands. Each major mode can define, redefine or undefine its own key bindings, creating a local keymap (e.g., c-mode). Each minor mode can do so too (e.g., flymake). Each portion of text can also do so (e.g., tables).

Description of some prefix keys:

* C-xcommand prefix key
* M-command prefix key
* C-cmode specific prefix key
* C-hhelp prefix key

Commands to bind keys:

* global-set-key ''k'' ''com''bind key ''k'' to ''com'' globally
* local-set-key ''k'' ''com''bind key ''k'' to ''com'' locally (major mode)

Notes:

* Menu and mouse key bindings can also be set.

== Storing Key Bindings ==

In the Emacs ''init'' file, you can either set global key bindings or “hook” local key bindings to mode hooks (i.e., callbacks, slots).

* global-set-keyadds a binding to the global map
* local-set-keyadds a binding to the local (major mode) map
* kbdconverts a string to a key sequence

Examples:

Global key binding:

* (global-set-key (kbd "C-c d") ’duplicate-line)
* (global-set-key (kbd "C-c d") (kbd "C-a C-@ C-e M-w RET C-y"))
* (global-set-key (kbd "C-c d") "\C-a\C- \C-n\M-w\C-y")

Local key binding:

* (add-hook ’LaTeX-mode-hook 
 (lambda () (local-set-key (kbd "C-c n") 
 ’forward-paragraph)))

== The Emacs Help System ==

Emacs has a handy help system for quick lookup of various features, topics, functions and key bindings.

* {{Keys|C-h ?}} show the help system shortcuts
* C-h ''key''run help system with shortcut ''key''

Some useful help keys:

* {{Keys|C-h a}} show apropos page about a keyword
* {{Keys|C-h k}} ''keybind''show help for function bound to ''keybind''
* {{Keys|C-h b}} show all key bindings
* {{Keys|C-h f}} show documentation for function
* {{Keys|C-h m}} show documentation for current modes
* {{Keys|C-h v}} show documentation for variable
* {{Keys|C-h w}} show what keys a command is bound to
* {{Keys|C-h t}} start the emacs tutorial
* ''prefix'' C-hshow all key binds starting with ''prefix''

== Modes ==

Modes are used to define the types of data being edited in buffers, or what Emacs calls “the language”.

Every buffer has exactly one major mode which defines its language (C, Java, English, IRC, ...) and provides basic elements like syntax highlighting and (re)defines functions and their key bindings for relevant actions (e.g., comments).

Each buffer can have zero or more minor modes enabled which provide non-specific functionality such as spell checking or line wrapping (i.e., mode independent).

== ediff ==

ediff (emacs-diff) is a mode for Emacs where you can view and merge difference between two or three buffers.

* ediffselect files to view their differences
* ediff-buffersselect buffers to view their differences

In ediff-mode:

* switch between horizontal/vertical view
* ?view ediff help
* pview previous difference
* nview next difference
* aset buffer b’s area to what’s in a’s
* bset buffer a’s area to what’s in b’s
* qquit ediff session

== Spell Checking ==

* {{Keys|M-$}} check spelling at word or active region
* ispellcheck active region or entire buffer
** iaccept word and insert into personal dictionary
** ?show ispell help
** RETend current ispell session

* ESC TABcomplete current word from dictionary
* flyspell-modeenable “on the fly” spell checking
* flyspell-prog-modespell check comments and strings

== References ==

* Emacs Wiki: http://emacswiki.org/
* Emacs Docs: https://www.gnu.org/software/emacs/manual/html_node/emacs/index.html
* Emacs Help

[[Category:Tutorial]]

Talk:Emacs Code Browser

2012-04-06T07:01:43Z

Kindahero:

Stuff that should go in this page are:
* current combinations of ECB and CEDET versions that work well together
* how ECB and CEDET are related
* verify if ECB is being actively developed (last release was 3 years ago)
* what is ECB's relationship to tags systems. E.g. GNU Global

: True. I have never been able to run ECB because of incompatibilities. It would be nice if some one with enough knowledge with CEDET and ECB post those details. -- [[User:Kindahero|Kindahero]] 10:01, 6 April 2012 (EEST)

Category:Built-in Package

2012-04-06T04:15:04Z

Kindahero:

Built-in packages come bundled with the default Emacs installation. Many of the started their life as third party packages and we eventually added to Emacs.

[[Category:Package]]

User talk:Chachi

2012-04-05T18:23:33Z

Kindahero: Created page with "Welcome to WikEmacs. -- ~~~~"

Welcome to WikEmacs. -- [[User:Kindahero|Kindahero]] 21:23, 5 April 2012 (EEST)

File talk:Emacs-explanation.png

2012-04-05T18:22:16Z

Kindahero: Created page with "This looks cool, way better than the one I uploaded. Thank you -- ~~~~"

This looks cool, way better than the one I uploaded. Thank you -- [[User:Kindahero|Kindahero]] 21:22, 5 April 2012 (EEST)

Mediawiki.el

2012-04-05T15:10:21Z

Kindahero:

{{Package
|name=mediawiki.el
|description=Mediawiki interface and markup mode
|author= Jerry et al
|maintainer=Mark A. Hershberger
|source=https://code.launchpad.net/~hexmode/mediawiki-el/trunk
|in_emacs=no
|Development status=active
|website=https://code.launchpad.net/~hexmode/mediawiki-el
}}

'''Mediawiki.el''' is a package to help add content to any mediawiki
site including ''WikEmacs''. It comes with a [[Major Mode]] to support editing
Mediawiki markup.

==Setup==

Install '''mediawiki.el''' from [[el-get]] or [[ELPA]].

==Customization==

; {{Command|load-library RET mediawiki RET}}
: Load the library

; {{CustomizeVariable|mediawiki-site-alist}}
: Configure as follows and save your settings
:: '''Site Name''': WikEmacs
:: '''URL''': ''http://wikemacs.org/w/''
:: '''Username''': ''InCognito''
:: '''Password''': ''s!cr!t''
:: '''First Page''': ''Main Page''
: You can provide "Username" and "Password" in your [[.authinfo]] file. home directory.

Alternatively you can add this snippet of Emacs Lisp code to your
[[.emacs]]:

<syntaxhighlight lang="lisp">
(require 'mediawiki)

(setq mediawiki-site-alist '(("Wikipedia" "http://en.wikipedia.org/w" "" "" "Main Page")
("WikEmacs" "http://wikemacs.org/w/" "" "" "Main Page")))

;; Emacs users care more for WikEmacs than Wikipedia :-)
(setq mediawiki-site-default "WikEmacs")
</syntaxhighlight>

You can naturally add more MediaWiki sites to the
'''mediawiki-site-alist''' variable.

==Usage==
; {{Command|mediawiki-site}}
: Choose a site (say "WikEmacs") for the current session.

; {{CommandKeys|C-c C-o|mediawiki-open}}
: Open a page. To edit the main page, type "Main Page". Make your edits.

; {{CommandKeys|C-x C-s|mediawiki-save}}
: Submit your modifications.

; {{CommandKeys|C-c|mediawiki-save-and-bury}}
: Submit modifications and bury the buffer.

== Helpful Keybindings==

; {{CommandKeys|C-return|mediawiki-open-page-at-point}}
: Follow or browse to a WikiLink.

; {{CommandKeys|M-g|mediawiki-reload}}
: Reload a page

==Customizations==
=== Word Wrap ===

Mediawiki sites are generally [[Emacs_Terminology#Fill |unfilled]]: do not add hard line breaks within a paragraph. There are various ways to wrap lines [[Emacs_Terminology#Screen Lines |visually]] while you edit. For example in Emacs 24 you may want to enable [[Visual Line]] mode with a [[mode hook]]:

<syntaxhighlight lang="lisp">
(setq mediawiki-mode-hook (lambda ()
(visual-line-mode 1)))
</syntaxhighlight>

=== Edit or Create a page in a web browser ===

Right now '''Mediawiki.el''' fails silently whenever the site asks for number challenge
(spam protection). The following snippet allows you to edit/create a
page in a web browser

<syntaxhighlight lang="lisp">
(defun yyr-mediawiki-browser-edit/create-page (page &optional site)
"Edit a page in browser, asks for page name (sitename also if needed)"
(interactive "sPage name (words): ")
(let* ((site (mediawiki-prompt-for-site))
(url (mediawiki-site-extract site 1))
(index "index.php?title=")
(et "&action=edit"))
(funcall 'browse-url
(message "%s%s%s%s"
url index (mediawiki-translate-pagename page) et))))
</syntaxhighlight>

Call {{Function| yyr-mediawiki-browser-edit/create-page}}

=== key binding to open current editing file in web browser? ===

bind {{Function|mediawiki-browse}} to some key chord. The following
uses {{Keys|C-c o}}

<syntaxhighlight lang="lisp">

(define-key mediawiki-mode-map (kbd "C-c o") 'mediawiki-browse)

</syntaxhighlight>

==External Links==
*[http://www.emacswiki.org/emacs/MediaWikiMode EmacsWiki:MediaWikiMode]
*[https://launchpad.net/mediawiki-el Project Page]

[[Category:Third Party Package]]
[[Category:Markup languages]]

WikEmacs:About

2012-04-05T15:10:01Z

Kindahero:

WikEmacs is a community-maintained wiki about GNU Emacs. It was [http://batsov.com/articles/2012/03/26/wikemacs-the-other-emacs-wiki/ started in 2012] and its infrastructure is currently maintained by [[User:Bozhidar|Bozhidar Batsov]].

See [[WikEmacs:Guidelines]] for guidelines on contributing. If you have questions or comments you can post to the Discussion pages or the Google discussion [https://groups.google.com/forum/?fromgroups#!forum/wikemacs group].

Thanks to the people that brought us the original [http://emacswiki.org/ EmacsWiki]. Thanks to everyone who supported the idea for a new wiki. And thanks in advance to all future contributors!

[[Category:WikEmacs]]

Category talk:Native Package

2012-04-05T14:35:19Z

Kindahero:

Itsn't Built-in package a better term than native? I've never heard anyone using the term native for packages coming with Emacs, but I've seen built-in used a lot (even by package.el) [[User:Bozhidar|Bozhidar]]
:+1! Is there any mechanism to rename a category? [[User:GregLucas|GregLucas]] 17:25, 5 April 2012 (EEST)
:: @GregLucas I am not sure there is one, '''Bots''' are meant for such things, wow edit conficts first time around I see on wikemacs.. So we are doing very well -- [[User:Kindahero|Kindahero]] 17:35, 5 April 2012 (EEST)
: may be "built-in" is better. I don't have any idea on this, I was just adding that since it was there before. -- [[User:Kindahero|Kindahero]] 17:30, 5 April 2012 (EEST)

: I also think "built-in" is the most widely used terminology. [[User:Francesco|Francesco]] 17:32, 5 April 2012 (EEST)

Category talk:Native Package

2012-04-05T14:30:22Z

Kindahero:

Talk:ERC

2012-04-05T13:36:17Z

Kindahero:

==The "common" customizations==
Please, whoever put it there, remove it. Let's not have this wiki turn into the old EmacsWiki. [[User:Damd|damd]] 15:45, 5 April 2012 (EEST)
: apologies for the ignorance, but I don't understand what you mean. do you mean we should n't put any customisation information in a page.? How would a reader know how to use a package with out that information.? -- [[User:Kindahero|Kindahero]] 16:36, 5 April 2012 (EEST)

Emacs Lisp Cheat Sheet

2012-04-05T11:45:32Z

Kindahero: Undo revision 2549 by Kindahero (talk)

==Special form==
special form has its own rule for which arguments are evaluated
{| class="wikitable"
|+ Special Form
|-
| Purpose || Forms
|-
| Definition || defconst defun defvar
|-
| Binding constructs || let let* function
|-
| Conditional evaluation || and cond if or
|-
| Sequential evaluation || prog1 prog2 progn
|-
| Iteration || while function
|-
| Syntactic extension || defmacro
|-
| Quoting || quote
|-
| Assignment || setq setq-default
|-
| Nonlocal Exits || catch condition-case unwind-protect
|-
| Save || save-current-buffer save-excursion save-restriction save-window-excursion
|-
| Other || interactive track-mouse with-output-to-temp-buffer
|}

==Standard Library==

=== Buffer ===
'''buffer''' is a lisp object containing text to be edited
{| class="wikitable"
|+ Buffer related function and ''Variable''
|-
| Category || Functions ''Variable''
|-
| Basic || bufferp current-buffer set-buffer save-current-buffer with-current-buffer with-temp-buffer
|-
| Buffer Names || buffer-name rename-buffer get-buffer generate-new-buffer-name
|-
| Buffer File Name || buffer-file-name ''buffer-file-name'' ''buffer-file-truename'' ''buffer-file-number'' get-file-buffer find-buffer-visting set-visted-file-name list-buffers-directory
|-
| Buffer Modification || buffer-modified-p set-buffer-modified-p restore-buffer-modified-p not-modified buffer-modified-tick buffer-chars-modified-tick
|-
| Buffer Modification Time || verify-visited-file-modtime clear-visited-file-modtime visited-file-modtime set-visited-file-modtime ask-user-about-supersession-threat
|-
| Read-Only Buffers || ''buffer-read-only'' ''inhibit-read-only'' toggle-read-only barf-if-buffer-read-only
|-
| Buffer List || buffer-list other-buffer last-buffer bury-buffer unbury-buffer
|-
| Creating Buffers || get-buffer-creat generate-new-buffer
|-
| Killing Buffers || kill-buffer kill-buffer-query-function ''kill-buffer-hook'' ''buffer-offer-save'' ''buffer-save-without-query buffer-live-p
|-
| Indirect Buffers || make-indirect-buffer clone-indirect-buffer buffer-base-buffer
|-
| Swapping Text Between Two Buffers || buffer-swap-text
|-
| Buffer Gap || gap-position gap-size
|}

[[Category:Emacs Lisp]]

Category:Emacs Lisp

2012-04-05T11:44:25Z

Kindahero: Created page with "'''Emacs Lisp''' is special for Emacs. So an additional category. Category:Programming languages"

'''Emacs Lisp''' is special for Emacs. So an additional category.

[[Category:Programming languages]]

Emacs Lisp

2012-04-05T11:42:58Z

Kindahero:

{{Infobox major-mode
|title = Emacs Lisp
|library = lisp-mode
|command = emacs-lisp-mode
|builtin = yes
|auto activates = *.el, .emacs, _emacs
}}

'''Emacs Lisp''' is a dialect of the [[Lisp]] programming language used by GNU Emacs. Most of the editing functionality built into Emacs is written in Emacs Lisp, with the remainder being written in C (as is the Lisp interpreter itself). Users of Emacs commonly write Emacs Lisp code to customize and extend Emacs.

Emacs Lisp is also commonly referred to as "elisp" or "Elisp". Files containing Emacs Lisp code use the <tt>.el</tt> filename suffix; when [[byte-compile]]d, the same filename prefix is used but with the <tt>.elc</tt> filename suffix.

Emacs Lisp is a [https://hornbeck.wordpress.com/2009/07/05/lisp-1-vs-lisp-2/ Lisp-2], which means that a single identifier (in Lisp terminology, "symbol") can simultaneously exist as ("be bound to") both a function and a variable.

= Basic setup =

You can customize the way Emacs edits and displays this and all other [[:Category:Lisp|lisp languages]] with {{CustomizeGroup|lisp}}.

= Helpful keybindings =

; {{Keys|M-TAB}}
: Complete at point

; {{Keys|C-M-q}}
: Indent the [[S-expression]] following [[point and mark|point]]

; {{Keys|C-M-x}}
: Evaluate the <code>defun</code> at [[point and mark|point]]

= Common customizations =

== Outlining ==

For [[Org]]-style outlining, add the following snippet to your {{EmacsConfigFile}}.

<source lang="lisp">
;; Turn on outline minor mode
(add-hook 'emacs-lisp-mode-hook 'outline-minor-mode)

;; Add key bindings for Org-style outline cycling
(add-hook 'outline-minor-mode-hook
(lambda ()
(define-key outline-minor-mode-map [(control tab)] 'org-cycle)
(define-key outline-minor-mode-map [(shift tab)] 'org-global-cycle)))
</source>

Now visit any elisp file (say {{Command|find-library RET outline}}) and keep pressing {{Keys|S-TAB}} and see what happens. Experiment similarly with {{Keys|C-TAB}}.

== Indentation ==

Add the following snippet to your {{EmacsConfigFile}}, so that you don't have to indent deliberately. See {{Command|reindent-then-newline-and-indent}}.

<source lang="lisp">
(add-hook 'emacs-lisp-mode-hook
(lambda nil
(local-set-key [(return)] 'reindent-then-newline-and-indent)))
</source>

== Always keep parentheses balanced ==

See [[Skeleton#Keep some chars always balanced]]

== Scope ==
By default elisp uses [[dynamic scope]]. Since Emacs 24 [[lexical scope]] has been added. 
To use lexical binding, an Emacs-lisp source file must set a file-variable {{Variable|lexical-binding}} to <tt>t</tt> in the file header, e.g., by using a first line like: 

;;; -*- lexical-binding: t -*-

= External links =

* [http://www.gnu.org/software/emacs/manual/html_node/elisp/index.html Emacs Lisp manual]

[[Category:Lisp]]
[[Category:Emacs Lisp]]
[[Category:Programming]]
[[Category:Programming languages]]

Emacs Lisp Cheat Sheet

2012-04-05T11:40:35Z

Kindahero:

Emacs Lisp Cheat Sheet

2012-04-05T11:40:18Z

Kindahero:

Template talk:Package

2012-04-05T11:37:12Z

Kindahero:

I'm wondering if it would be a good idea to add some optional fields like latest version (ala wikipedia) and maybe something about the package's availability for installation via package.el (GNU ELPA, Marmalade, MELPA...) for third party packages. What do you think? [[User:Bozhidar|Bozhidar]]

:Yes, it would be good to have that info as well. I will try to change that Package template according to that. -- [[User:Kindahero|Kindahero]] 14:36, 5 April 2012 (EEST)

Template talk:Package

2012-04-05T11:36:58Z

Kindahero:

I'm wondering if it would be a good idea to add some optional fields like latest version (ala wikipedia) and maybe something about the package's availability for installation via package.el (GNU ELPA, Marmalade, MELPA...) for third party packages. What do you think? [[User:Bozhidar|Bozhidar]]

Yes, it would be good to have that info as well. I will try to change that Package template according to that. -- [[User:Kindahero|Kindahero]] 14:36, 5 April 2012 (EEST)

Category:Wanted Package

2012-04-05T07:18:29Z

Kindahero: Created page with "Category:Package"

[[Category:Package]]

Category:Sciences

2012-04-05T07:15:42Z

Kindahero: Created page with "Category:Emacs"

[[Category:Emacs]]

Talk:Main Page

2012-04-05T07:14:21Z

Kindahero: /* needed plugins */ new section

== IMPORTANT: Offline discussion ==

There is a Google group for discussion of the site: https://groups.google.com/forum/?fromgroups#!forum/wikemacs so we should probably favor posting there. [[User:PhilHudson|PhilHudson]] 16:16, 26 March 2012 (EEST)

== IMPORTANT: Content Quality guidelines ==
I think before flame wars and fights among members, we should form
proper/strict guide lines for each aspect of the site. Wikipedia has very strict
rules about that., even their bots can tell the content quality of a
page. we can create articles in "WikEmacs" Namespace. [[User:Kindahero|Kindahero]] 23:57, 1 April 2012 (EEST)

== Structure ==
I would like to structure the Main Page in boxes like here [http://www.webos-internals.org] the Featured Article/Project. Any objections?
And maybe [[User:Bozhidar]] should write some lines about the relation to the "old" EmacsWiki?--[[User:Kenda|Kenda]] 19:58, 24 March 2012 (EET)

This seems like a good idea. Might help us utilize better the screen estate. As for the relation to the EmacsWiki - it is more or less non-existing. We have the permission from Alex (kensanata) to migrate any content we choose to, but they won't be supporting us in any way. [[User:Bozhidar|Bozhidar]] 20:28, 26 March 2012 (EEST)

== Markup Conventions==

=== Wikipedia linking convention ===

Could/should we have a convention for formatting and placement of wikipedia links on pages? [[User:PhilHudson|PhilHudson]] 22:37, 24 March 2012 (EET)

=== EmacsWiki linking convention ===

Similar question to Wikipedia wrt EmacsWiki [[User:PhilHudson|PhilHudson]] 23:06, 24 March 2012 (EET)

== Describing Modes and Packages ==

=== Naming Conventions ===

I'd like to suggest *not* suffixing (links to) modes with "-mode". Thus: "org" not "org-mode". For consistency I've been adding links titled "org-mode" until now, since that one was already created when I started. [[User:PhilHudson|PhilHudson]] 22:09, 24 March 2012 (EET)

:Agreed, let's use the "friendly" name of a package. I'd say "Org", "Gnus", "YASnippet", etc. [[User:GregLucas|GregLucas]]

:I actually disagree. E.g. [[Java]] could be a page describing the different Java capabilities of Emacs, with links to the different JavaScript modes. This is especially true for [[JavaScript]], where the [[js-mode]] shipped with the latest Emacs is completely different from the other widely used [[js2-mode]] by Yegge. [[User:Damd|Damd]] 18:20, 25 March 2012 (EEST)

::Hm, good point about disambiguation... I still like the idea of using "titles" vs "commands", though. E.g. a [[Java]] page describing the built-in support (Java Mode) and then linking to articles on related packages (JDEE, etc) and why you might consider them instead. [[User:GregLucas|GregLucas]] 19:32, 25 March 2012 (EEST)

:::How would we handle e.g. [[Haskell]]? Emacs doesn't ship with any Haskell mode as far as I know... [[User:Damd|damd]] 19:58, 25 March 2012 (EEST)

== Template for mode-with-github-source pages? ==

Can Wikimedia do page templates? I'm sure the answer is yes. [[User:PhilHudson|PhilHudson]] 23:07, 24 March 2012 (EET)

== Issues ==
* The "Editing Help" link goes to a virgin page, not the full help page.
* Add [http://meta.wikimedia.org/wiki/Help:Footnotes Mediawiki Cite extension] to enable footnotes.
* Add [http://meta.wikimedia.org/wiki/Category#Visualizing_category_tree Category Tree extension] to explore various categories like [[:Category:Programming languages]].

== Syntax highlighting ==

Could we install a MediaWiki plugin which lets us do proper syntax highlighting of different languages? [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi] looks like a good alternative. [[User:Damd|damd]] 20:07, 25 March 2012 (EEST)

:I've already installed it, but it doesn't seem to work properly (the fonts seem terribly small) and it doesn't support Emacs Lisp. [[User:Bozhidar|Bozhidar]] 20:24, 26 March 2012 (EEST)

::Are you sure the font size is not because of your web browser settings? They look just fine when I try it. About the Elisp support, we can still use just "lisp" until someone gets around to writing a version for Elisp. [[User:Damd|damd]] 18:44, 31 March 2012 (EEST)

::: I also found font size in the code snippets are inconveniently low. I dont have any special settings for my browser. I am on recent firefox. [[User:Kindahero|Kindahero]] 18:52, 31 March 2012 (EEST)

::::We could customize the CSS for the syntax highlighting plugin, but first let's make sure it's actually something in the CSS that causes this.
::::<pre>This is just an ordinary PRE element.</pre>
::::<syntaxhighlight lang="html4strict">This is a PRE element generated by the syntax highlighting plugin.</syntaxhighlight>
::::Is the font in both examples too tiny? If so, I suggest you check your browser settings. You can configure this in the "Content" section of Firefox's settings. [[User:Damd|damd]] 19:13, 1 April 2012 (EEST)
::::: I only find the second one small not the both. I started with 'firefox -safe-mode' still the same. It seems its general problem with Geshi see http://stackoverflow.com/questions/5354968/changing-the-font-size-of-code-formatted-by-syntaxhighlight-geshi-in-mediawiki [[User:Kindahero|Kindahero]] 20:25, 1 April 2012 (EEST)

==fails to create thumbnails==
I think some adminstative settings must be made in order to produce thumbnails of the pictures automatically. Can anyone do this .? check out [[Dictem]] to see what I am talking about. [[User:Kindahero|Kindahero]] 16:21, 31 March 2012 (EEST)
: found this link, http://www.mediawiki.org/wiki/Manual:Configuration_settings#Thumbnail_settings [[User:Kindahero|Kindahero]] 16:24, 31 March 2012 (EEST)
:: another link, http://www.mwusers.com/forums/showthread.php?1334-Resized-thumbnail-images-not-displaying Feel free to delete these links [[User:Kindahero|Kindahero]] 16:28, 31 March 2012 (EEST)

:I see that on <nowiki>[[File:Screenshot-dictem-buffer.jpg]]</nowiki>, the main image is not displayed. The "Full resolution" link shows a valid image. By the way, this type of question might be appropriate for [https://groups.google.com/forum/?fromgroups#!forum/wikemacs Google Groups:WikEmacs]. [[User:Xophist|Xophist]] 21:31, 1 April 2012 (EEST)

== needed plugins ==

* cite.php is needed to show references using <ref> </ref> for example http://wikemacs.org/wiki/Battery#How_to_show_battery_status_only_on_laptop.3F has ref, but not working.?

Battery

2012-04-05T07:02:31Z

Kindahero:

{{Package
|name=Battery.el
|author = [[Ralph Schleicher]]
|description=Shows the battery status in the [[mode line]]
|source=http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/battery.el
|maintainer=[[FSF]]
|in_emacs=yes
|Development status=active
}}

== Basic setup ==

; {{Command|display-battery-mode}}
: Add your battery status to the [[Modeline]]

; {{Command|battery}}
: View battery status

== Customization ==
===Gnu/Linux ===
==== How to show battery status only on laptop? ====
if a device has no battery, we don't want to '''display-battery-mode''' be
enabled.<ref>http://stackoverflow.com/questions/5562974/emacs-is-it-running-on-laptop-or-on-desktop</ref>

<source lang="lisp">
(require 'battery)
(when (and battery-status-function
(not (string-match-p "N/A"
(battery-format "%B"
(funcall battery-status-function)))))
(display-battery-mode 1))
</source>

== See Also ==
[[time]]

[[Category:Desktop Management]]
[[Category:Appearance]]

Battery

2012-04-05T07:01:43Z

Kindahero: customization

{{Package
|name=Battery.el
|author = [[Ralph Schleicher]]
|description=Shows the battery status in the [[mode line]]
|source=http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/battery.el
|maintainer=[[FSF]]
|in_emacs=yes
|Development status=active
}}

== Basic setup ==

; {{Command|display-battery-mode}}
: Add your battery status to the [[Modeline]]

; {{Command|battery}}
: View battery status

== Customization ==
===Gnu/Linux ===
==== How to show battery status only on laptop? ====
if a device have no battery, we don't want to '''display-battery-mode''' be
enabled.<ref>http://stackoverflow.com/questions/5562974/emacs-is-it-running-on-laptop-or-on-desktop</ref>

<source lang="lisp">
(require 'battery)
(when (and battery-status-function
(not (string-match-p "N/A"
(battery-format "%B"
(funcall battery-status-function)))))
(display-battery-mode 1))
</source>

== See Also ==
[[time]]

[[Category:Desktop Management]]
[[Category:Appearance]]

Ido

2012-04-05T06:42:59Z

Kindahero: author info

{{Package
|name=Ido
|author = Kim F. Storm
|description=Interactive Do [[MiniBuffer]] Enhancement
|source=http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/ido.el
|maintainer=[[FSF]]
|in_emacs=yes
|Development status=active
}}

'''Ido''' - Interactively do things is a very convenient way to find files and switch buffers.

== Basic setup ==

<source lang="lisp">
(ido-mode)
(ido-everywhere 1)
</source>

== Helpful keybindings ==

; {{Keys|C-s}}
: Move to next ido suggestion.

; {{Keys|C-r}}
: Move to previous ido suggestion.

== Common Customization ==

=== Enable Fuzzy Matching ===

<syntaxhighlight lang="lisp">
(setq ido-enable-flex-matching t)
</syntaxhighlight>

=== Ignore Case ===

{{Snippet|(setq ido-case-fold t)}}

=== Virtual Buffers ===

If [[Recentf]] is enabled, you can use {{CommandKeys|C-x b|ido-switch-buffer}} to visit recently closed files by enabling virtual buffers:
{{Snippet|(setq ido-use-virtual-buffers t)}}

=== Prevent Auto-Merge ===

Ido's default behavior when there is no matching file in the current directory is to look in recent working directories. If you prefer to limit {{CommandKeys|C-x C-f|ido-find-file}} to the current directory you can disable this ''auto-merge'' behavior:
{{Snippet|(setq ido-auto-merge-work-directories-length -1) ;; disable auto-merge}}

You can still look in other working directories explicitly with {{Keys|M-s|ido-merge-work-directories}}.

=== Directory Caching on Windows ===

On [[Windows]] operating systems it can be unreliable to cache directory listings: the directory may not appear to be modified even though files have been added or removed. Ido caches directory listings by default, which may cause confusion on Windows. You can disable caching:

<syntaxhighlight lang="lisp">
(when (equal system-type 'windows-nt)
(setq ido-max-dir-file-cache 0)) ; caching unreliable
</syntaxhighlight>

== See Also ==

[[Helm]]

== External Links ==

[http://www.masteringemacs.org/articles/2010/10/10/introduction-to-ido-mode/ Introduction to Ido Mode]

[[Category:Completion]]
[[Category:Native Package]]
[[Category:MiniBuffer]]
[[Category:Convenience]]
[[Category:Minor Mode]]
[[Category:Buffer Navigation]]
[[Category:Popular Package]]

WikEmacs:Guidelines

2012-04-05T06:31:44Z

Kindahero:

'''How can we maintain and improve quality of this Wiki?'''
* Stick to Emacs-24 and Emacs-23.
* Keep things short and sweet. Mark things that should stand out in '''bold'''.
* Use [http://en.wikipedia.org/wiki/Active_voice Active voice]
* Give tips. Document things that are difficult to find or share your wisdom.
* Don't reproduce existing documentation. Instead link to them.
* It's OK to write long tutorial Pages. Use '''Tutorial:Tutorial Namespace''' for it. Categorize them so it is easy to find.
* If you are a regular blogger, donate your article to this Wiki.
* Use '''Discussion page''' to discuss things. Don't put them in articles themselves. Always sign your comments using <nowiki>~~~~</nowiki>.
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or any other code hosting site.
* {{Note}} this is not a QA site, any question you have are better answered at [http://stackoverflow.com/questions/tagged/emacs Stackoverflow site]. If have got answer to a good question add your solution in the appropriate page.
* Any '''Code snippets''' are most welcome., But please make sure to write comments about that, like that snippet precisely does. If it has any limitations, document them.

== Mediawiki Help ==
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Help with Mediawiki markup]

== Creating new pages ==
To create a new page, do this:
# Visit [http://wikemacs.org/w/index.php?title=Template:NewPage&action=edit Template:NewPage] and copy the text area to clipboard. Feel free to modify the template.
# Goto [[WikEmacs:Scratch Buffer]]
# Add this <nowiki>[[Test Page]]</nowiki> and save the scratch buffer.
# Click on the new Wiki link to create a blank page and paste the contents of clipboard there.
# Save the newly created page.
# Now you have a basic template which you can expand upon. Add content to the new page as you please.

== Templates ==
There are templates defined for referencing ''variables'', ''function'', ''command'', ''keys'', ''manual'' etc. Use them for uniform experience. See [[:Category:Templates]]. Each template page should describe how to use it. A few common examples:

{| border="1" cellpadding="5" cellspacing="0" width="75%"
|-
!What it looks like
!What you type
|-
| {{Manual|emacs|Major-Modes|Major Modes}}
| <pre>{{Manual|emacs|Major-Modes|Major Modes}}</pre>
|-
| {{CommandKeys|C-x C-f|find-file}}
| <pre>{{CommandKeys|C-x C-f|find-file}}</pre>
|-
| {{Keys|C-x C-c}}
| <pre>{{Keys|C-x C-c}}</pre>
|-
| {{Keys|C-x f|set-fill-column}}
| <pre>{{Keys|C-x f|set-fill-column}}</pre>
|-
| {{Command|find-file}}
| <pre>{{Command|find-file}}</pre>
|-
| {{CustomizeVariable|c-default-style}}
| <pre>{{CustomizeVariable|c-default-style}}</pre>
|-
| {{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}
| <pre>{{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}</pre>
|}

== Categories ==

There are special categories defined for ''Operating system'', ''Emacs releases'', ''Programming languages'' etc. Use these when possible or introduce new ones as required. See [[Special:Categories]].

[[Category:WikEmacs Contributor]]

Talk:W3m-el

2012-04-05T04:07:10Z

Kindahero:

Please avoid writing personal experiences in the articles, we can use talk pages to discuss the quality of the content and its problems. -- [[User:Kindahero|Kindahero]] 07:07, 5 April 2012 (EEST)

Talk:W3m-el

2012-04-05T04:06:21Z

Kindahero: Created page with "Please avoid writing personal experiences in the articles, we can use talk pages to discuss the quality of the content."

Please avoid writing personal experiences in the articles, we can use talk pages to discuss the quality of the content.

Template:Filename

2012-04-05T03:09:59Z

Kindahero:

<includeonly><tt>{{{1}}}</tt></includeonly><noinclude>

{{Delete | use [[Template:File]] instead}}

[[Category:Templates]]

</noinclude>

Template:Filename

2012-04-05T03:09:36Z

Kindahero:

Template talk:Dirname

2012-04-05T03:07:31Z

Kindahero:

Is this intended to be a replacement for [[Template:Directory]], or is it just something to experiment with? If it is just for testing I'd suggest removing it from [[:Category:Templates]]. The idea of that category is to have a list of recommended/actively used templates so that contributors can scan the list and find what they should be using. Thanks! [[User:GregLucas|GregLucas]] 21:42, 4 April 2012 (EEST)
: I created this without knowing that there is another template for same purpose. So I don't have any problem in deleting this. -- [[User:Kindahero|Kindahero]] 05:57, 5 April 2012 (EEST)
: added delete tag. I think admin have to take action on this -- [[User:Kindahero|Kindahero]] 06:07, 5 April 2012 (EEST)

Template talk:Dirname

2012-04-05T02:57:51Z

Kindahero:

Eproject.el

2012-04-04T17:41:16Z

Kindahero:

{{Package
|name=eproject.el
|description=Yet another project management frame-work
|maintainer=Jonathan Rockway
|source=https://github.com/jrockway/eproject
}}

'''Note: there is another package also called eproject'''

The eproject package allows you to define project definitions in Emacs which then will get automatically associated when you open files.

== Configuration ==

<source lang="lisp">
(require 'eproject)
(require 'eproject-compile)

(define-project-type debian-package
(generic)
(look-for "debian")
:common-compiles ("dpkg-buildpackage -rfakeroot"))

(define-project-type android-package
(generic)
(look-for "AndroidManifest.xml")
:common-compiles ("ant compile"))

(define-project-type rockbox
(generic-git)
(look-for "../rockbox.git/rbutil")
:common-compiles ("make" "make install" "make fullzip"))

(define-project-type chrome-extension
(generic)
(look-for "manifest.json"))
</source>

Now when a file is opened that is in the tree for one of these definitions you will find it both in {{minor-mode|eproject}} and a buffer local variable {{Variable|eproject-root}} defined.

[[Category:Third Party Package]]
[[Category:Project Management]]

Category:Project Management

2012-04-04T17:40:19Z

Kindahero: Created page with "Category:Development"

[[Category:Development]]

Keyboard macros

2012-04-04T12:19:42Z

Kindahero:

{{Manual|emacs|Basic-Keyboard-Macro|Basic Keyboard Macro}}

'''Keyboard macros''' can be used to automate or repeat tedious editing tasks in Emacs.

==Example usage==
Consider the standard <code>*scratch*</code> buffer:

<pre>
;; This buffer is for notes you don't want to save, and for Lisp evaluation.
;; If you want to create a file, visit that file with C-x C-f,
;; then enter the text in that file's own buffer.
</pre>

Suppose you want to remove the first occurrence of the letter "a" in that piece of text. You could write a [[regular expression]] to do the job, but let's assume you want to use a keyboard macro this time.

# Make sure [[point]] is at the start of the buffer.
# Hit <code>C-x (</code> to start recording your macro. '''Note:''' If you hit <code>C-g</code> or if an error occurs, your keyboard macro recording will stop.
# Hit <code>C-s</code> followed by <code>a</code> to find the first "a". Now, point is right after the first "a" in the text.
# Hit backspace to delete that "a".

The first occurrence of "a" of the first line has been deleted. Let's move point to the beginning of the next line and then stop recording.

<ol start="5">
<li>Hit <code>C-e C-f</code> to move point to the beginning of the next line.</li>
<li>Hit <code>C-x )</code> to finish the recording of our macro.</li>
</ol>

The macro you have just recorded performs the operation of removing the first occurrence of "a" it can find and then moving point to the next line.

<ol start="7">
<li>Hit <code>C-x e</code> once to call that macro.</li>
<li>Continue hitting <code>e</code> to call it several times. Hit any other key to get out of the macro repetition.</li>
</ol>

==Repeating a macro==
To repeat a macro e.g. five times, you could hit <code>C-x e e e e e</code>. This could become tedious if you want to repeat it a greater amount of times, so an alternative is to provide a numeric argument to <code>C-x e</code>, e.g. <code>C-u 25 C-x e</code>.

===Repeating until there's an error===
Provide a <code>0</code> prefix argument to <code>C-x e</code> to execute a macro from point until there is an error, e.g. <code>C-u 0 C-x e</code> or <code>M-0 C-x e</code>. See [[prefix arguments]].

===Repeating a macro on every line in a region===
If you've recorded a macro which you want to call on every line in a buffer, you can use <code>C-x C-k r</code>, which applies the macro to every line in the region.

==Saving macros==
{{Manual|saving keyboard macros|(emacs) Save Keyboard Macro}}

===By name===
To give a macro a name which you can later call using <code>M-x</code>, hit <code>C-x C-k n</code>. Try to avoid strange characters in the name. Once you've given it a name, you can execute it using <code>M-x the-name-of-the-macro</code>.

===Binding to a key===
To bind a keyboard macro to a key using <code>C-x C-k b</code>. To avoid problems caused by overriding existing bindings, the key sequences <code>C-x C-k 0</code> through <code>C-x C-k 9</code> and <code>C-x C-k A</code> through <code>C-x C-k Z</code> are reserved for your own keyboard macro bindings. You can, however, bind a keyboard macro to whatever you like.

===Saving it permanently===
To save a keyboard macro for future Emacs sessions, go to your init file (or wherever you want to store it) and hit <code>M-x insert-kbd-macro</code>. Then enter the name of the macro you would like to save. This will insert Emacs Lisp code which defines the macro you chose, so you can use it in future sessions.

Using the example in the beginning of this article, let's say you named that macro <code>remove-first-a</code>. If you use <code>insert-kbd-macro</code> to insert the Lisp for that macro, this is what would come up:

<pre>
(fset 'remove-first-a
(lambda (&optional arg) "Keyboard macro." (interactive "p") (kmacro-exec-ring-item (quote ([19 97 13 backspace 5 6] 0 "%d")) arg)))
</pre>

If you have bound the macro to a key as described in the previous section, you can generate the code for that as well by prefixing the insert-kbd-macro call with [[prefix argument|<code>C-u</code>]].

[[Category:Intermediate]]
[[Category:Editing]]

Category talk:Templates

2012-04-04T11:40:10Z

Kindahero:

One of the things that need to be resolved is this.

* When would namespace be used? When would categories be used?
* Templates are in the namespace of their own.

It is easy to search for them. One can search for articles in a given namespace. I don't see why a separate category is needed for this?

I want the current contributors to Wikemacs to start organizing around separate namespaces rather than the current default organizing around categories.

: I agree, using different namespaces would more good. may be we can formalize which things go where.
:* WikEmacs -- licence, user, and others()
:* Category -- articles
:* Tutorial -- all tutorials
:* Help -- any help material for users
:* Template -- for all templates
:* Bots -- for all bots (none is written yet by the way)
: any other new spaces
: -- [[User:Kindahero|Kindahero]] 14:27, 4 April 2012 (EEST)

:: Okay It seems we cant do that, even though we write any thing in any namespaces, all of them can only be organized through Categories. So I think we can write articles in different namespace(as I wrote above), but they all organized through categories. I could be wrong or may some one else has better Idea -- [[User:Kindahero|Kindahero]] 14:39, 4 April 2012 (EEST)

Category talk:Templates

2012-04-04T11:39:18Z

Kindahero:

One of the things that need to be resolved is this.

* When would namespace be used? When would categories be used?
* Templates are in the namespace of their own.

It is easy to search for them. One can search for articles in a given namespace. I don't see why a separate category is needed for this?

I want the current contributors to Wikemacs to start organizing around separate namespaces rather than the current default organizing around categories.

: I agree, using different namespaces would more good. may be we can formalize which things go where.
:* WikEmacs -- licence, user, and others()
:* Category -- articles
:* Tutorial -- all tutorials
:* Help -- any help material for users
:* Template -- for all templates
:* Bots -- for all bots (none is written yet by the way)
: any other new spaces
: -- [[User:Kindahero|Kindahero]] 14:27, 4 April 2012 (EEST)

:: Okay It seems we cant do, even though we write any thing in any namespaces, all of them can be organized through Categories. So I think we can write articles in different namespace(as I wrote above), but they all organized through categories. I could be wrong or may some one else has better Idea -- [[User:Kindahero|Kindahero]] 14:39, 4 April 2012 (EEST)

Category talk:Templates

2012-04-04T11:29:05Z

Kindahero:

Category talk:Templates

2012-04-04T11:27:58Z

Kindahero:

User talk:GregLucas

2012-04-04T08:09:47Z

Kindahero:

I see you removed answered questions from [[Talk:Main Page]]. I think we can archive it instead of deletion (similer to what they do on wikipedia) and I have no clue how to do it though. [[User:Kindahero|Kindahero]] 22:43, 30 March 2012 (EEST)
:Yes, archiving would probably be better. I was just looking to remove some clutter! [[User:GregLucas|GregLucas]] 22:54, 30 March 2012 (EEST)

Thanks for the new templates and clean up. did you edit all template categories by hand.? I think we better start writing some '''bots''' for doing all renaming and for common tasks. I don't know yet how to create them yet. -- [[User:Kindahero|Kindahero]] 11:09, 4 April 2012 (EEST)

Main Page

2012-04-04T08:04:39Z

Kindahero: note about guideline

'''WikEmacs''' (pronounced wiki-macs) collects useful resources for working with [[GNU Emacs]]. Think of it as a
'''[http://www.emacswiki.org/ next generation, improved Emacs Wiki]''' . You can also think of it as a '''pastebin''' or '''gist''' for Emacs users.
[[File:Emacs_parts.png|320px|thumb|right|Basic terminology of typical Emacs GUI Frame]]

---------
'''First time visitors''' can start [[#Explore this wiki | exploring WikEmacs]]. We have added lots of useful pages since the launch of WikEmacs. We want to keep you excited and engaged.

-----------
We need more '''[[:Category:WikEmacs Contributor|WikEmacs Contributor]]s'''. You can help the following way.

{{Note| First of all, Please take a minute to look at
[[WikEmacs:Guidelines]] before start editing.}}

* Priority tasks
** Migrate content from [http://www.emacswiki.org EmacsWiki]. Please adopt the following approach -''I found this on EmacsWiki which was helpful. But it took me a lot of time to find it. Now that I have found it, I will put it in WikEmacs so that others can benefit from it.''

* Intermediate tasks
** Provide tutorials or content for the [[:Category:Popular Package|Popular Packages]] or [[:Category:Native Package|Native Packages]].
** Add more content to [[Special:ShortPages]]
** Document or add more [[:Category:Third Party Package|Third Party Package]]s

* Other tasks
** Copy edit [[Special:RecentChanges]] or be a moral police
** Add more members to various [[Special:Categories]]
** Categorize one of these pages [[Special:UncategorizedPages]]

----
'''Emacs News'''

The latest stable release of Emacs is [[GNU Emacs 23|Emacs-23.4]].
The next major release is [[GNU Emacs 24|Emacs-24.1]] and is in ''Pretest'' stage.

Emacs is available on all popular [[:Category:Install Or Upgrade| Operating Systems]] including [[Installing Emacs on GNU/Linux | GNU/Linux]], [[Installing Emacs on BSD |BSD]], [[Installing Emacs on OS X | OS X]] and [[Installing Emacs on Windows| Windows]]. It supports a variety of [[:Category:Programming languages|programming languages]].

= Explore this wiki =

To explore this wiki proceed as follows:
* Search for or visit a page of interest
* At the end of the page, there is a list of categories
* Click on individual categories and it will give you a list of all pages that will be of interest to you.

== What is your comfort level with Emacs? ==
* [[:Category:Beginner|Beginner]]
* [[:Category:Intermediate|Intermediate]]
* [[:Category:Expert|Expert]]
** Are you a maintainer of a [[:Category:Native Package|Native Package]]? If you don't find information about your package, please add it. No one else is better than your are to write about it.
** Have you developed any [[:Category:Third Party Package|Third Party Package]]s? Consider writing about what it is and how to use it.
* [[:Category:Vim User|Vim User]]
* [[:Category:User Level|Other]]

== What do you want to accomplish now? ==
* [[:Category:Install Or Upgrade|Install Or Upgrade]]
* [[:Category:Customization|Customize Emacs]]
* [[Key Bindings|Tweak Key Bindings]]
* [[:Category:Tutorial|Learn more Emacs (Tutorials)]]

== What do you use Emacs for? ==
* [[:Category:Text Editing|Text Editing]]
* [[:Category:Programming|Programming]]
* [[:Category:Document authoring|Document authoring]]
* [[:Category:Organizer|Getting Organized]]
* [[:Category:Email|Emailing]]
* [[:Category:Chat|Chatting]]
* [[:Category:Blogging|Blogging]]
* [[:Category:Browse|Browsing]]
* [[:Category:Workflow|Other]]

== How do you involve yourself with the community? ==
* [[:Category:Emacs User]]
* [[:Category:Emacs Contributor]]
* [[:Category:WikEmacs Contributor]]
* [[:Category:User Role|Other]]

[[Category:WikEmacs]]

WikEmacs:Guidelines

2012-04-04T08:01:47Z

Kindahero: correction

'''How can we maintain and improve quality of this Wiki?'''
* Stick to Emacs-24 and Emacs-23.
* Keep things short and sweet. Mark things that should stand out in '''bold'''.
* Use [http://en.wikipedia.org/wiki/Active_voice Active voice]
* Give tips. Document things that are difficult to find or share your wisdom.
* Don't reproduce existing documentation. Instead link to them.
* It's OK to write long tutorial Pages. Use '''Tutorial:Tutorial Namespace''' for it. Categorize them so it is easy to find.
* If you are a regular blogger, donate your article to this Wiki.
* Use '''Discussion page''' to discuss things. Don't put them in articles themselves. Always sign your comments using <nowiki>~~~~</nowiki>.
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or any other code hosting site.
* {{Note}} this is not a QA site, any question you have are better answered at [http://stackoverflow.com/questions/tagged/emacs Stackoverflow site]. If have got answer to good question add your solution in appropriate page
* Any '''Code snippets''' are most welcome., But please make sure to write comments what that snippet precisely does. If it has any limitations, document them.

== Mediawiki Help ==
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Help with Mediawiki markup]

== Creating new pages ==
To create a new page, do this:
# Visit [http://wikemacs.org/w/index.php?title=Template:NewPage&action=edit Template:NewPage] and copy the text area to clipboard. Feel free to modify the template.
# Goto [[WikEmacs:Scratch Buffer]]
# Add this <nowiki>[[Test Page]]</nowiki> and save the scratch buffer.
# Click on the new Wiki link to create a blank page and paste the contents of clipboard there.
# Save the newly created page.
# Now you have a basic template which you can expand upon. Add content to the new page as you please.

== Templates ==
There are templates defined for referencing ''variables'', ''function'', ''command'', ''keys'', ''manual'' etc. Use them for uniform experience. See [[:Category:Templates]]. Each template page should describe how to use it. A few common examples:

{| border="1" cellpadding="5" cellspacing="0" width="75%"
|-
!What it looks like
!What you type
|-
| {{Manual|emacs|Major-Modes|Major Modes}}
| <pre>{{Manual|emacs|Major-Modes|Major Modes}}</pre>
|-
| {{CommandKeys|C-x C-f|find-file}}
| <pre>{{CommandKeys|C-x C-f|find-file}}</pre>
|-
| {{Keys|C-x C-c}}
| <pre>{{Keys|C-x C-c}}</pre>
|-
| {{Keys|C-x f|set-fill-column}}
| <pre>{{Keys|C-x f|set-fill-column}}</pre>
|-
| {{Command|find-file}}
| <pre>{{Command|find-file}}</pre>
|-
| {{CustomizeVariable|c-default-style}}
| <pre>{{CustomizeVariable|c-default-style}}</pre>
|-
| {{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}
| <pre>{{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}</pre>
|}

== Categories ==

There are special categories defined for ''Operating system'', ''Emacs releases'', ''Programming languages'' etc. Use these when possible or introduce new ones as required. See [[Special:Categories]].

[[Category:WikEmacs Contributor]]

WikEmacs:Guidelines

2012-04-04T08:00:07Z

Kindahero: another

'''How can we maintain and improve quality of this Wiki?'''
* Stick to Emacs-24 and Emacs-23.
* Keep things short and sweet. Mark things that should stand out in '''bold'''.
* Use [http://en.wikipedia.org/wiki/Active_voice Active voice]
* Give tips. Document things that are difficult to find or share your wisdom.
* Don't reproduce existing documentation. Instead link to them.
* It's OK to write long tutorial Pages. Use '''Tutorial:Tutorial Namespace''' for it. Categorize them so it is easy to find.
* If you are a regular blogger, donate your article to this Wiki.
* Use '''Discussion page''' to discuss things. Don't put them in articles themselves. Always sign your comments using <nowiki>~~~~</nowiki>.
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or any other code hosting site.
* {{Note}} this is not a QA site, any question you have are better answered at [http://stackoverflow.com/questions/tagged/emacs Stackoverflow site]. If have got answer to good question add your solution in appropriate page
* Any '''Code snippets''' are most welcome., But please make sure write what that code snippet precisely does. If that has any limitations, document them.

== Mediawiki Help ==
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Help with Mediawiki markup]

== Creating new pages ==
To create a new page, do this:
# Visit [http://wikemacs.org/w/index.php?title=Template:NewPage&action=edit Template:NewPage] and copy the text area to clipboard. Feel free to modify the template.
# Goto [[WikEmacs:Scratch Buffer]]
# Add this <nowiki>[[Test Page]]</nowiki> and save the scratch buffer.
# Click on the new Wiki link to create a blank page and paste the contents of clipboard there.
# Save the newly created page.
# Now you have a basic template which you can expand upon. Add content to the new page as you please.

== Templates ==
There are templates defined for referencing ''variables'', ''function'', ''command'', ''keys'', ''manual'' etc. Use them for uniform experience. See [[:Category:Templates]]. Each template page should describe how to use it. A few common examples:

{| border="1" cellpadding="5" cellspacing="0" width="75%"
|-
!What it looks like
!What you type
|-
| {{Manual|emacs|Major-Modes|Major Modes}}
| <pre>{{Manual|emacs|Major-Modes|Major Modes}}</pre>
|-
| {{CommandKeys|C-x C-f|find-file}}
| <pre>{{CommandKeys|C-x C-f|find-file}}</pre>
|-
| {{Keys|C-x C-c}}
| <pre>{{Keys|C-x C-c}}</pre>
|-
| {{Keys|C-x f|set-fill-column}}
| <pre>{{Keys|C-x f|set-fill-column}}</pre>
|-
| {{Command|find-file}}
| <pre>{{Command|find-file}}</pre>
|-
| {{CustomizeVariable|c-default-style}}
| <pre>{{CustomizeVariable|c-default-style}}</pre>
|-
| {{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}
| <pre>{{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}</pre>
|}

== Categories ==

There are special categories defined for ''Operating system'', ''Emacs releases'', ''Programming languages'' etc. Use these when possible or introduce new ones as required. See [[Special:Categories]].

[[Category:WikEmacs Contributor]]