WikEmacs - User contributions [en]

User:Bozhidar

2018-09-20T20:00:56Z

Bozhidar: Update the info about me

My name is Bozhidar and I've started WikEmacs a few years back as an attempt to create a solid and clean alternative to EmacsWiki.

I maintain a couple of smallish open-source Emacs projects here and there (mostly on [https://github.com/bbatsov GitHub]) and I’ve contributed to many more.

I blog infrequently on [http://emacsredux.com Emacs Redux].

[[Category:WikEmacs Contributor]]

CIDER

2014-03-22T12:25:20Z

Bozhidar: Update maintainer

{{Package
|name=CIDER
|description=Emacs Client for Clojure's nREPL
|author=Tim King
|maintainer=Bozhidar Batsov
|source=https://github.com/clojure-emacs/cider
}}

== Basic setup ==

<source lang="lisp">
(add-to-list 'load-path "/path/to/cider/directory")
(require 'cider)
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

* [[SLIME]]
* [[swank-clojure]]

== Project Pages ==
* [https://github.com/clojure-emacs/cider GitHub Repo]

== Tutorial Pages ==

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

Main Page

2013-04-14T22:02:24Z

Bozhidar: Grand reopening message

'''Grand reopening!''' '''WikEmacs''' is now under new management and will remain open indefinitely. Spread the word!
[[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|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|short pages]].
** Document or add more [[:Category:Third Party Package|third party packages]].

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

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

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

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]]

== 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:Entertainment|Entertainment]]
* [[:Category:Workflow|Other]]

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

[[Category:WikEmacs]]

Main Page

2013-01-27T09:14:22Z

Bozhidar:

'''Important: ''' '''WikEmacs''' will be shutting down around March 2013. Please, visit '''[http://www.emacswiki.org/ Emacs Wiki]''' instead.
[[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|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|short pages]].
** Document or add more [[:Category:Third Party Package|third party packages]].

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

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

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

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]]

== 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:Entertainment|Entertainment]]
* [[:Category:Workflow|Other]]

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

[[Category:WikEmacs]]

Scala-mode2

2012-12-18T09:38:29Z

Bozhidar: added a basic page on scala-mode2

{{Package
|name=scala-mode2
|description=major mode for Scala programming
|author=Heikki Vesalainen
|maintainer=Heikki Vesalainen
|source=https://github.com/hvesalai/scala-mode2
|in_emacs=no
}}

'''scala-mode2''' provides Emacs font-lock, indentation, and navigation for the [[Scala]] programming language. It's a
rewrite from scratch of the older [[scala-mode]] and has improved support for Scala 2.9+.

== Basic setup ==

<source lang="lisp">
(require 'scala-mode2)
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

[[scala-mode]]

== Project Pages ==

* [https://github.com/hvesalai/scala-mode2 GitHub Project]

== Tutorial Pages ==

[[Category:Programming]][[Category:Third Party Package]]

Scala-mode

2012-12-18T09:34:52Z

Bozhidar: added a basic page on scala-mode

{{Package
|name=scala-mode
|description=major mode for Haskell programming
|author=Martin Odersky
|maintainer=n/a
|source=http://lampsvn.epfl.ch/svn-repos/scala/scala-tool-support/trunk/src/emacs/
|in_emacs=no
}}

'''scala-mode''' provides Emacs font-lock, indentation, and navigation for the [[Scala]] programming language.

== Basic setup ==

<source lang="lisp">
(require 'scala-mode-autoloads)
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

[[scala-mode2]]

== Project Pages ==

== Tutorial Pages ==

* [http://www.scala-lang.org/node/354 Emacs, scala-mode and yasnippet]

[[Category:Programming]][[Category:Third Party Package]]

Twittering-mode

2012-12-15T09:19:32Z

Bozhidar: added a basic page for twittering-mode

{{Package
|name=Twittering-mode
|description=Twitter client for Emacs
|author=Yuto Hayamizu
|maintainer=Yuto Hayamizu
|source=https://github.com/hayamiz/twittering-mode
}}

'''Twittering-mode''' is a Twitter client for Emacs.

== Basic setup ==

<source lang="lisp">
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

* [[identica-mode]]

== Project Pages ==

* [http://twmode.sourceforge.net/ Official Site]
* [https://github.com/hayamiz/twittering-mode GitHub Repo]

== Tutorial Pages ==

[[Category:Third Party Package]]

BibTeX

2012-12-07T20:21:24Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by Bozhidar

[[Category:Markup languages]][[Category:Document authoring]]

Java-mode

2012-12-07T20:21:23Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by GregLucas

{{Infobox major-mode
|title = Emacs Lisp
|library = cc-mode
|command = java-mode
|builtin = yes
|auto activates = *.java
}}

'''java-mode''' comes with Emacs which provides very basic [[syntax highlighting]].

== Basic Setup ==

==See also ==
[[Java]]

[[Category:Java]]
[[Category:Programming languages]]

Package.el

2012-12-07T20:21:21Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by Jstein

{{Package
|name=package.el
|description=Package Manager
|author=Tom Tromey
|maintainer=[[FSF]]
|source=http://repo.or.cz/w/emacs.git/blob_plain/HEAD:/lisp/emacs-lisp/package.el
|in_emacs=24
|Development status=active
}}

package.el is the built-in package manager in Emacs 24.

== Install package.el on Emacs 23 ==
<tt>package.el</tt> is bundled with Emacs 24, but it’s not bound to Emacs 24. Before it became part of Emacs it was an external package, known as package.el that was tied to repository called ELPA ('''E'''macs '''L'''isp '''P'''ackage '''A'''rchive). So even if you’re an Emacs 23 user you can copy the latest version of <tt>package.el</tt> from [http://repo.or.cz/w/emacs.git/blob_plain/1a0a666f941c99882093d7bd08ced15033bc3f0c:/lisp/emacs-lisp/package.el here] and enjoy it.

== Configuration ==
Put the following snippet of code near the beginning of your Emacs config, since you’ll definitely want packages installed via <tt>package.el</tt> to be initalized ''before'' you start tweaking them.
<source lang="lisp">
(require 'package)
(package-initialize)
</source>

== Select Packages from the List ==
[[File:M-x package-list-packages.png|400px|thumb|right|M-x package-list-packages]]
<tt>package.el</tt> connects to a list of package repositories, retrieves the list of the packages there, presents it to you in a interactive fashion and lets you install the packages you like (of course you can also remove the ones you don’t like). <tt>package.el</tt> understands the dependencies between packages and if one package requires others to run they will be installed automatically (which is really neat).

The magic starts with the command {{Command|package-list-packages}}. At this point you should see something in the lines of this.

You can navigate the list of packages, mark the ones you want to install with the “i” key or the ones you want removed with the “d” key and when you’re done you can press the “x” key to execute the scheduled actions.

Initially <tt>package.el</tt> didn’t provide the option to update a package, but that should be fixed in recent Emacs builds. According to this [http://lists.gnu.org/archive/html/emacs-devel/2011-09/msg00371.html thread] you can even update all of the installed packages by using the “U” key in the packages list view (I guess that a small “u” would update only one package). Unfortunately my build is lacking those capabilities so I cannot comment of their usability.

== How to add additional repository ==
The list of available packages is short because the official Emacs 24 package repository has strict licensing (and source code) requirements to include a package there. Luckily there are a number of community-maintained <tt>package.el</tt> repos around with much more relaxed requirements. Probably the most popular of them is [http://marmalade-repo.org/ Marmalade], created by [http://nex-3.com/ Nathan Weizenbaum] of Sass and Haml fame. You can include it in your <tt>package-archives</tt> list like this:

<source lang="lisp">
(add-to-list 'package-archives '("marmalade" . "http://marmalade-repo.org/packages/"))
</source>

Marmalade provides a web based UI for package upload and search (both quite buggy unfortunately) and the ability to share the maintenance of a package between several people, who’ll be able to upload new version of the package. There’s also a Emacs Lisp Marmalade tool, that allows you to submit packages directly from Emacs.

== How to use it with a custom build ==
Using the <tt>package.el</tt> UI is ok if you’re a casual Emacs user, but what if you have a custom Emacs configuration, stored under version control, that you’d like to instantly deploy on any OS/machine (like Emacs Prelude). Here in play comes <tt>package.el</tt>’s programmer interface. In [https://github.com/bbatsov/emacs-prelude Emacs Prelude] I use the following code to install a list of required packages automatically on Emacs startup (if necessary):

<source lang="lisp">
;; Comment out if you've already loaded this package...
(require 'cl)

(defvar my-packages
'(ack-and-a-half auctex clojure-mode coffee-mode deft expand-region
gist groovy-mode haml-mode haskell-mode inf-ruby
magit magithub markdown-mode paredit projectile python
sass-mode rainbow-mode scss-mode solarized-theme
volatile-highlights yaml-mode yari zenburn-theme)
"A list of packages to ensure are installed at launch.")

(defun my-packages-installed-p ()
(loop for p in prelude-packages
when (not (package-installed-p p)) do (return nil)
finally (return t)))

(unless (my-packages-installed-p)
;; check for new packages (package versions)
(package-refresh-contents)
;; install the missing packages
(dolist (p prelude-packages)
(when (not (package-installed-p p))
(package-install p))))
</source>

This code check if all of the packages in the list are installed and if any of them are not installed if refreshes the local package database (in the case a required package for recently added to the remote repo) and installs them.

== How to publish it to Marmalade ==
To be able to publish a package to Marmalade (or another repo) it should comform a standardized structure. A single-file package might look like this:

<source lang="lisp">
;;; sass-mode.el --- Sass major mode

;; Copyright 2007-2010 Nathan Weizenbaum

;; Author: Nathan Weizenbaum <nex342@gmail.com>
;; URL: http://github.com/nex3/sass-mode
;; Version: 3.0.20
;; Package-Requires: ((haml-mode "3.0.20"))

;; Code goes here

;;; sass-mode.el ends here
</source>

A multi-file package should have an additional file named
`<name>-pkg.el` that should look like this:

<source lang="lisp">
(define-package "sass-mode" "3.0.20"
"Sass major mode"
'((haml-mode "3.0.20")))

</source>

== package.el Repositories ==

* [[ELPA]]
* [[MELPA]]
* [[Marmalade]]

== External links ==

* [http://batsov.com/articles/2012/02/19/package-management-in-emacs-the-good-the-bad-and-the-ugly/ Package Management in Emacs]

[[Category:Package Manager]][[Category:Built-in Package]]

Input methods

2012-12-07T20:20:28Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by S9nn9s

'''Input Methods''' allow you to enter characters that are not supported by your keyboard.

= Helpful keybindings =

; {{CommandKeys|C-x C-m C-\|set-input-method}}
: Switch to a new input method.

; {{CommandKeys|C-h C-\|describe-input-method}}
: Tells you how to enter a particular character for the current input mehtod.

; {{CommandKeys|C-\|toggle-input-method}}
: Switch to your default input method.

= TeX input method =

; {{Keys|C-x C-m C-\ TeX}}
: To type greek character λ, enter \lambda.

= Accented characters =

; {{Keys|C-x C-m C-\ latin-1-prefix RET}}
: Use this method to input accented characters. When you type `" u' you get `ü'. Another You method is to {{PrefixKeys|C-x 8}}.

= [[GNU/Linux]] =
= [[OS X]] =
= [[Windows]] =
= [[Emacs-24]] =
= [[Emacs-23]] =
= Recommended Reading =
= Project Pages =
= Tutorial Pages =

== See also ==
[[Ibus]] mode, a minor mode, allow user to use ibus input framework directly in Emacs, with Chinese and Japnese support.
[[Category:Mule]]

MELPA

2012-12-07T20:20:26Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by Bozhidar

'''MELPA''' (or Milkypostman’s ELPA or Milkypostman’s Experimental Lisp Package Repository if you’re not into the whole brevity thing) is a [[package.el]] repository for development versions of Emacs packages (hot from the repo).

== Basic setup ==

<source lang="lisp">
(add-to-list 'package-archives
'("melpa" . "http://melpa.milkbox.net/packages/") t)
</source>

== Helpful keybindings ==

== See Also ==

* [[Marmalade]]
* [[package.el]]
* [[el-get]]

== Project Pages ==

* [http://melpa.milkbox.net/ Project Page]
* [https://github.com/milkypostman/melpa GitHub Repo]

== Tutorial Pages ==

* [http://batsov.com/articles/2012/04/06/melpa-homebrew-emacs-edition/ MELPA - Homebrew (Emacs Edition)]

[[Category:Project Management]][[Category:Convenience]]

Installing Emacs

2012-12-07T20:20:25Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by Bozhidar

== Emacs Releases ==

The latest released version of Emacs is [[:Category:Emacs-24.1|Emacs-24.2]].

== Installing Emacs ==

Emacs is available on all popular [[:Category:Operating System | operating systems]] including [[GNU/Linux]], [[OSX]], [[FreeBSD]] and [[Windows]]. See the respective pages for installation instruction and platform specific customization:

* [[Installing Emacs on OS X]]
* [[Installing Emacs on GNU/Linux]]
* [[Installing Emacs on Windows]]
* [[Installing Emacs on FreeBSD]]

[[Category:Install Or Upgrade‎]]

Haskell-mode

2012-12-07T20:20:12Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by Bozhidar

{{Package
|name=haskell-mode
|description=major mode for Haskell programming
|author=Chris Done
|maintainer=Chris Done
|source=https://github.com/haskell/haskell-mode
|in_emacs=no
}}

'''haskell-mode''' provides Emacs font-lock, indentation, and navigation for the [[Haskell]] programming language.

== Basic setup ==

<source lang="lisp">
(require 'haskell-mode)
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

== Project Pages ==

* [https://github.com/haskell/haskell-mode GitHub Project]

== Tutorial Pages ==

* [http://www.youtube.com/watch?v=E6xIjl06Lr4 New features in haskell-mode (screencast)]

[[Category:Programming]][[Category:Third Party Package]]

Skeleton

2012-12-07T20:19:52Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by Bozhidar

{{Package
|name=Skeleton
|description=Insert the complex statement skeleton SKELETON describes very concisely.
|source=http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/skeleton.el
|maintainer=[[FSF]]
|in_emacs=yes
|Development status=active
}}

'''Skeleton''' library can be used to create documents based on
templates.

== Keep some chars always balanced ==

Use the below setting to insert paired characters with just a single
keystroke.

For example, typing ''''('''' will automatically insert ''''()'''' in
to the buffer. Similarly typing ''''{'''' will automatically insert
''''{}''''. This way parenthesis, quotes etc will always remain
balanced. This setting is quite useful if you are editing
[[Emacs Lisp]], [[C]] etc.

<source lang="lisp">
(require 'skeleton)
(setq skeleton-pair t)
(global-set-key "\"" 'skeleton-pair-insert-maybe)
(global-set-key "(" 'skeleton-pair-insert-maybe)
(global-set-key "[" 'skeleton-pair-insert-maybe)
(global-set-key "{" 'skeleton-pair-insert-maybe)
</source>

[[Category:Minor Mode]]
[[Category:Built-in Package]]
[[Category:Editing]]
[[Category:Template System]]

Main Page

2012-12-07T20:19:25Z

Bozhidar: Reverted edits by Debrita (talk) to last revision by 66.223.230.23

'''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|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|short pages]].
** Document or add more [[:Category:Third Party Package|third party packages]].

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

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

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

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]]

== 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:Entertainment|Entertainment]]
* [[:Category:Workflow|Other]]

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

[[Category:WikEmacs]]

WikEmacs:Community portal

2012-10-16T09:34:53Z

Bozhidar: Questions should be asked on the discussion page for each article

Welcome to the community portal. This is the place to find out what is happening on WikEmacs. Learn what tasks need to be done and what groups there are to join, and share news about recent events or current activities taking place on WikEmacs.

WikEmacs was just started and we need more '''[[:Category:WikEmacs Contributor|WikEmacs Contributor]]s'''. You can help the following way.

* 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]]

== Google group ==
[https://groups.google.com/forum/?fromgroups#!forum/wikemacs WikEmacs on Google Group] for more general questions regarding the wiki.

CIDER

2012-09-11T15:54:06Z

Bozhidar: added a basic nrepl.el page

{{Package
|name=nrepl.el
|description=Emacs Client for Clojure's nREPL
|author=Tim King
|maintainer=Tim King
|source=https://github.com/kingtim/nrepl.el
}}

== Basic setup ==

<source lang="lisp">
(add-to-list 'load-path "/path/to/nrepl.el/directory")
(require 'nrepl)
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

* [[SLIME]]
* [[swank-clojure]]

== Project Pages ==
* [https://github.com/kingtim/nrepl.el GitHub Repo]

== Tutorial Pages ==

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

Installing Emacs on GNU/Linux

2012-09-06T14:01:53Z

Bozhidar:

Check if your distribution already provides an Emacs version of interest to you.

If you are interested in daily builds or latest binaries, try building from [https://github.com/emacsmirror/emacs source] or try one of the following unofficial repositories based on your distribution.

= Debian =

== Emacs 23 ==

<source lang="bash">
$ sudo apt-get install emacs
</source>

== Emacs 24 ==
See [http://emacs.naquadah.org/ emacs-snapshot APT repo]. The page contains installation instructions. High quality, highly recommended builds! After adding the repo according to the instructions linked to above, install with the following command:
<source lang="bash">
$ sudo apt-get install emacs-snapshot
</source>

= Ubuntu =

== Emacs 23 ==

<source lang="bash">
$ sudo apt-get install emacs
</source>

== Emacs 24 ==
<source lang="bash">
$ sudo apt-add-repository ppa:cassou/emacs
$ sudo apt-get install emacs-snapshot
</source>

= Gentoo =
See [http://www.gentoo.org/proj/en/lisp/emacs/emacs.xml Emacs on Gentoo page].

= Arch Linux =

== Emacs 23 ==

<source lang="bash">
$ sudo pacman -S emacs
</source>

== Emacs 24 ==

See [http://aur.archlinux.org/packages.php?ID=33337 emacs-bzr] package from [http://aur.archlinux.org/index.php AUR]

= Slackware =
Compile and Install using [http://github.com/cycojesus/slackbuilds/tree/master/e/emacs emacs.SlackBuild (unofficial)].

= Fedora =

== Emacs 23 ==
Available up to Fedora 16
<source lang="bash">
$ sudo yum install emacs
</source>

== Emacs 24 ==
Available from Fedora 17+
<source lang="bash">
$ sudo yum install emacs
</source>

= SusE =

== Emacs 23 ==

Available in 12.1 and 12.2. Before that? not sure.

<source lang="bash">
$ sudo zypper install emacs
</source>

== Emacs 24 ==

Not available till 12.2, but available from Factory repo. Add factory repo and then,

<source lang="bash">
$ sudo zypper install emacs
</source>

= Mandriva =
No pre-built packages.

[[Category:GNU/Linux]][[Category:Beginner]][[Category:Install Or Upgrade]]

Main Page

2012-09-06T13:59:57Z

Bozhidar: mostly cosmetic changes

'''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|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|short pages]].
** Document or add more [[:Category:Third Party Package|third party packages]].

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

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

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

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]]

== 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:Entertainment|Entertainment]]
* [[:Category:Workflow|Other]]

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

[[Category:WikEmacs]]

Wanderlust

2012-09-06T13:00:49Z

Bozhidar: moved here a troubleshooting section from the MELPA article

{{Package
|name=Wanderlust
|description=Wanderlust is an e-mail client especially suited to IMAP.
|source=https://github.com/wanderlust/
|in_emacs=no
|Development status=active
}}

== Introduction ==
Wanderlust is an in-Emacs mail reading application intended for use with IMAP. It is preferred by many expert Emacs users because it has by far the best native IMAP support of any Emacs mail reading system, but it is very poorly documented (at least in English) and a challenge for naive users to install and configure.

Unfortunately, the Wanderlust home page, at [http://www.gohome.org/wl/], has not been maintained in many years. Development appears to take place almost entirely within various informal github repositories. A full list of packages needed to run Wanderlust includes:

https://github.com/wanderlust/flim

https://github.com/wanderlust/semi

https://github.com/wanderlust/apel

https://github.com/wanderlust/wanderlust

Wanderlust is not currently available in [[ELPA]] but is available in [[El-get]] (though it doesn't seem to be able to checkout the repository).

== Troubleshooting ==

Installation from ELPA seems to be problematic, because of the [[flim]] package. See more at http://gelvaos.blogspot.com/2010/11/emacs-elpa-and-wanderlust.html

[[Category:Email]][[Category:Mail Client]][[Category:Third Party Package]][[Category:Popular Package]]

MELPA

2012-09-06T12:58:07Z

Bozhidar: Reverted edits by PuercoPop (talk) to last revision by 173.29.243.191

Marmalade

2012-09-06T12:56:57Z

Bozhidar: /* Project Pages */

'''Marmalade''' is a [[package.el]] repository, supported by the Emacs community. It's best known feature is the ability to submit Emacs packages directly via Marmalade's web UI.

== Basic setup ==

<source lang="lisp">
(require 'package)
(add-to-list 'package-archives
'("marmalade" . "http://marmalade-repo.org/packages/"))
(package-initialize)
</source>

== See Also ==

* [[MELPA]]
* [[package.el]]
* [[el-get]]

== Project Pages ==

* [http://marmalade-repo.org Project Page]
* [https://github.com/nicferrier/marmalade GitHub Repo]

== Tutorial Pages ==

[[Category:Project Management]][[Category:Convenience]]

Installing Emacs

2012-09-05T10:46:35Z

Bozhidar:

Package.el

2012-07-22T12:59:11Z

Bozhidar: /* Install package.el on Emacs 23 */

{{Package
|name=package.el
|description=Package Manager
|author=Tom Tromey
|maintainer=[[FSF]]
|source=http://repo.or.cz/w/emacs.git/blob_plain/HEAD:/lisp/emacs-lisp/package.el
|in_emacs=24
|Development status=active
}}

package.el is the built-in package manager in Emacs 24.

== Install package.el on Emacs 23 ==
<tt>package.el</tt> is bundled with Emacs 24, but it’s not bound to Emacs 24. Before it became part of Emacs it was an external package, known as package.el that was tied to repository called ELPA (that stood for Emacs Lisp Package Archive). So even if you’re an Emacs 23 user you can copy the latest version of <tt>package.el</tt> from [http://repo.or.cz/w/emacs.git/blob_plain/1a0a666f941c99882093d7bd08ced15033bc3f0c:/lisp/emacs-lisp/package.el here] and enjoy it.

== Configuration ==
Put the following snippet of code near the beginning of your Emacs config, since you’ll definitely want packages installed via <tt>package.el</tt> to be initalized ''before'' you start tweaking them.
<source lang="lisp">
(require 'package)
(package-initialize)
</source>

== How it works ==
What <tt>package.el</tt> basically does is that it connects to a list of package repositories, retrieves the list of the packages there, presents it to you in a interactive fashion and lets you install the packages you like (of course you can also remove the ones you don’t like). <tt>package.el</tt> understands the dependencies between packages and if one package requires others to run they will be installed automatically (which is really neat).

The magic starts with the command {{Command|package-list-packages}}. At this point you should see something in the lines of this.

You can navigate the list of packages, mark the ones you want to install with the “i” key or the ones you want removed with the “d” key and when you’re done you can press the “x” key to execute the scheduled actions.

Initially <tt>package.el</tt> didn’t provide the option to update a package, but that should be fixed in recent Emacs builds. According to this [http://lists.gnu.org/archive/html/emacs-devel/2011-09/msg00371.html thread] you can even update all of the installed packages by using the “U” key in the packages list view (I guess that a small “u” would update only one package). Unfortunately my build is lacking those capabilities so I cannot comment of their usability.

== How to add additional repository ==
You’d probably notice that your list of available packages is not particularly long. That’s because the official Emacs 24 package repository has a strict licensing (and source code) requirements to include a package there. Luckily there are a number of community-maintained <tt>package.el</tt> repos around with much more relaxed requirements. Probably the most popular of them is [http://marmalade-repo.org/ Marmalade], created by [http://nex-3.com/ Nathan Weizenbaum] of Sass and Haml fame. You can include it in your <tt>package-archives</tt> list like this:

<source lang="lisp">
(add-to-list 'package-archives '("marmalade" . "http://marmalade-repo.org/packages/"))
</source>

Marmalade provides a web based UI for package upload and search (both quite buggy unfortunately) and the ability to share the maintenance of a package between several people, who’ll be able to upload new version of the package. There’s also a Emacs Lisp Marmalade tool, that allows you to submit packages directly from Emacs.

== How to use it with a custom build ==
Using the <tt>package.el</tt> UI is ok if you’re a casual Emacs user, but what if you have a custom Emacs configuration, stored under version control, that you’d like to instantly deploy on any OS/machine (like Emacs Prelude). Here in play comes <tt>package.el</tt>’s programmer interface. In [https://github.com/bbatsov/emacs-prelude Emacs Prelude] I use the following code to install a list of required packages automatically on Emacs startup (if necessary):

<source lang="lisp">
;; Comment out if you've already loaded this package...
(require 'cl)

(defvar my-packages
'(ack-and-a-half auctex clojure-mode coffee-mode deft expand-region
gist groovy-mode haml-mode haskell-mode inf-ruby
magit magithub markdown-mode paredit projectile python
sass-mode rainbow-mode scss-mode solarized-theme
volatile-highlights yaml-mode yari zenburn-theme)
"A list of packages to ensure are installed at launch.")

(defun my-packages-installed-p ()
(loop for p in prelude-packages
when (not (package-installed-p p)) do (return nil)
finally (return t)))

(unless (my-packages-installed-p)
;; check for new packages (package versions)
(package-refresh-contents)
;; install the missing packages
(dolist (p prelude-packages)
(when (not (package-installed-p p))
(package-install p))))
</source>

This code check if all of the packages in the list are installed and if any of them are not installed if refreshes the local package database (in the case a required package for recently added to the remote repo) and installs them.

== How to publish it to Marmalade ==
To be able to publish a package to Marmalade (or another repo) it should comform a standardized structure. A single-file package might look like this:

<source lang="lisp">
;;; sass-mode.el --- Sass major mode

;; Copyright 2007-2010 Nathan Weizenbaum

;; Author: Nathan Weizenbaum <nex342@gmail.com>
;; URL: http://github.com/nex3/sass-mode
;; Version: 3.0.20
;; Package-Requires: ((haml-mode "3.0.20"))

;; Code goes here

;;; sass-mode.el ends here
</source>

A multi-file package should have an additional file named
`<name>-pkg.el` that should look like this:

<source lang="lisp">
(define-package "sass-mode" "3.0.20"
"Sass major mode"
'((haml-mode "3.0.20")))

</source>

== package.el Repositories ==

* [[ELPA]]
* [[MELPA]]
* [[Marmalade]]

== External links ==

* [http://batsov.com/articles/2012/02/19/package-management-in-emacs-the-good-the-bad-and-the-ugly/ Package Management in Emacs]

[[Category:Package Manager]][[Category:Built-in Package]]

Talk:IELM

2012-07-22T12:43:26Z

Bozhidar:

Please use [[WikEmacs:Guidelines#Creating new pages]]

Done. [[User:Bozhidar|Bozhidar]] 13:39, 28 March 2012 (EEST)

The previous undo of the spammers devastation was not enough.. unfortunately, I did not see the big problem, before I looked at the history
and earlier versions carefully.
Then, I had to undo about 8 changes, including two of my own attempts...

aargh!

Consider making it editable only for "logged in" people.
Martin

I boosted the spam protection measures seriously after the recent flood of spam. Accidents like this should no longer occur. [[User:Bozhidar|Bozhidar]]

Starter Kits

2012-06-25T06:04:34Z

Bozhidar:

= External Links =
* [https://github.com/bbatsov/emacs-prelude Emacs Prelude]
* [https://github.com/technomancy/emacs-starter-kit Emacs Starter Kit]
* [https://github.com/dimitri/emacs-kicker Emacs Kicker]

[[Category:Beginner]][[Category:Install Or Upgrade]]

Package.el

2012-06-25T06:03:59Z

Bozhidar:

{{Package
|name=package.el
|description=Package Manager
|author=Tom Tromey
|maintainer=[[FSF]]
|source=http://repo.or.cz/w/emacs.git/blob_plain/HEAD:/lisp/emacs-lisp/package.el
|in_emacs=24
|Development status=active
}}

package.el is the built-in package manager in Emacs 24.

== Install package.el on Emacs 23 ==
<tt>package.el</tt> is bundled with Emacs 24, but it’s not bound to Emacs 24. Before it became part of Emacs it was an external package, known as ELPA (I guess that stood for Emacs Lisp Package Manager or something similar). So even if you’re an Emacs 23 user you can copy the latest version of <tt>package.el</tt> from [http://repo.or.cz/w/emacs.git/blob_plain/1a0a666f941c99882093d7bd08ced15033bc3f0c:/lisp/emacs-lisp/package.el here] and enjoy it.

== Configuration ==
Put the following snippet of code near the beginning of your Emacs config, since you’ll definitely want packages installed via <tt>package.el</tt> to be initalized ''before'' you start tweaking them.
<source lang="lisp">
(require 'package)
(package-initialize)
</source>

== How it works ==
What <tt>package.el</tt> basically does is that it connects to a list of package repositories, retrieves the list of the packages there, presents it to you in a interactive fashion and lets you install the packages you like (of course you can also remove the ones you don’t like). <tt>package.el</tt> understands the dependencies between packages and if one package requires others to run they will be installed automatically (which is really neat).

The magic starts with the command {{Command|package-list-packages}}. At this point you should see something in the lines of this.

You can navigate the list of packages, mark the ones you want to install with the “i” key or the ones you want removed with the “d” key and when you’re done you can press the “x” key to execute the scheduled actions.

Initially <tt>package.el</tt> didn’t provide the option to update a package, but that should be fixed in recent Emacs builds. According to this [http://lists.gnu.org/archive/html/emacs-devel/2011-09/msg00371.html thread] you can even update all of the installed packages by using the “U” key in the packages list view (I guess that a small “u” would update only one package). Unfortunately my build is lacking those capabilities so I cannot comment of their usability.

== How to add additional repository ==
You’d probably notice that your list of available packages is not particularly long. That’s because the official Emacs 24 package repository has a strict licensing (and source code) requirements to include a package there. Luckily there are a number of community-maintained <tt>package.el</tt> repos around with much more relaxed requirements. Probably the most popular of them is [http://marmalade-repo.org/ Marmalade], created by [http://nex-3.com/ Nathan Weizenbaum] of Sass and Haml fame. You can include it in your <tt>package-archives</tt> list like this:

<source lang="lisp">
(add-to-list 'package-archives '("marmalade" . "http://marmalade-repo.org/packages/"))
</source>

Marmalade provides a web based UI for package upload and search (both quite buggy unfortunately) and the ability to share the maintenance of a package between several people, who’ll be able to upload new version of the package. There’s also a Emacs Lisp Marmalade tool, that allows you to submit packages directly from Emacs.

== How to use it with a custom build ==
Using the <tt>package.el</tt> UI is ok if you’re a casual Emacs user, but what if you have a custom Emacs configuration, stored under version control, that you’d like to instantly deploy on any OS/machine (like Emacs Prelude). Here in play comes <tt>package.el</tt>’s programmer interface. In [https://github.com/bbatsov/emacs-prelude Emacs Prelude] I use the following code to install a list of required packages automatically on Emacs startup (if necessary):

<source lang="lisp">
;; Comment out if you've already loaded this package...
(require 'cl)

(defvar my-packages
'(ack-and-a-half auctex clojure-mode coffee-mode deft expand-region
gist groovy-mode haml-mode haskell-mode inf-ruby
magit magithub markdown-mode paredit projectile python
sass-mode rainbow-mode scss-mode solarized-theme
volatile-highlights yaml-mode yari zenburn-theme)
"A list of packages to ensure are installed at launch.")

(defun my-packages-installed-p ()
(loop for p in prelude-packages
when (not (package-installed-p p)) do (return nil)
finally (return t)))

(unless (my-packages-installed-p)
;; check for new packages (package versions)
(package-refresh-contents)
;; install the missing packages
(dolist (p prelude-packages)
(when (not (package-installed-p p))
(package-install p))))
</source>

This code check if all of the packages in the list are installed and if any of them are not installed if refreshes the local package database (in the case a required package for recently added to the remote repo) and installs them.

== How to publish it to Marmalade ==
To be able to publish a package to Marmalade (or another repo) it should comform a standardized structure. A single-file package might look like this:

<source lang="lisp">
;;; sass-mode.el --- Sass major mode

;; Copyright 2007-2010 Nathan Weizenbaum

;; Author: Nathan Weizenbaum <nex342@gmail.com>
;; URL: http://github.com/nex3/sass-mode
;; Version: 3.0.20
;; Package-Requires: ((haml-mode "3.0.20"))

;; Code goes here

;;; sass-mode.el ends here
</source>

A multi-file package should have an additional file named
`<name>-pkg.el` that should look like this:

<source lang="lisp">
(define-package "sass-mode" "3.0.20"
"Sass major mode"
'((haml-mode "3.0.20")))

</source>

== package.el Repositories ==

* [[ELPA]]
* [[MELPA]]
* [[Marmalade]]

== External links ==

* [http://batsov.com/articles/2012/02/19/package-management-in-emacs-the-good-the-bad-and-the-ugly/ Package Management in Emacs]

[[Category:Package Manager]][[Category:Built-in Package]]

WikEmacs:Guidelines

2012-06-25T06:02:58Z

Bozhidar:

'''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. Assign categories for easily finding the tutorial.
* If you are a regular blogger, consider donating your articles to this Wiki.
* For discussions, use the '''Discussion page''' instead of posting to the article pages. Sign your comments using <nowiki>~~~~</nowiki>.
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or similar code hosting site.
* {{Note}} this is not a QA site. Emacs questions are better answered at [http://stackoverflow.com/questions/tagged/emacs Stackoverflow site]. However, if you have an answer to a good question or problem, add in the appropriate page.
* '''Code snippets''' are most welcome. But comment about what precisely the snippet does. Document any limitations as well.

== 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 uniformity. See [[:Category:Templates]]. Each template page should describe how to use that template. A few common examples:

{| border="1" cellpadding="5" cellspacing="0" width="75%"
|-
!What it looks like
!What you type
|-
| <h2>Headline text</h2>
| <pre>== Headline text ==</pre>
|-
| {{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 ==

Special categories, such as ''Operating system'', ''Emacs releases'', ''Programming languages'', should be used to introduce new categories. See [[Special:Categories]].

[[Category:WikEmacs Contributor]]

WikEmacs:Guidelines

2012-06-25T06:01:21Z

Bozhidar: Reverted edits by 58.185.208.69 (talk) to last revision by 188.143.232.12

Between me and my husband we've owned more MP3 pleayrs over the years than I can count, including Sansas, iRivers, iPods (classic & touch), the Ibiza Rhapsody, etc. But, the last few years I've settled down to one line of pleayrs. Why? Because I was happy to discover how well-designed and fun to use the underappreciated (and widely mocked) Zunes are.

Guru-mode

2012-06-25T05:59:02Z

Bozhidar:

{{Package
|name=guru-mode
|description=a minor-mode that helps you to use Emacs more effectively
|author=[[User:Bozhidar | Bozhidar Batsov]]
|maintainer=[[User:Bozhidar | Bozhidar Batsov]]
|source=https://github.com/bbatsov/guru-mode
}}

'''guru-mode''' disables some common keybindings and suggests the use of the established Emacs alternatives instead.

== Basic setup ==

<source lang="lisp">
(add-to-list 'load-path "/path/to/guru-mode/directory")
(require 'guru-mode)
(guru-mode +1) ;; to enable in all buffers
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

* [[Prelude]]

== Project Pages ==
* [https://github.com/bbatsov/guru-mode GitHub Repo]

== Tutorial Pages ==

[[Category:Convenience]][[Category:Third Party Package]]

Troubleshooting

2012-06-24T19:47:34Z

Bozhidar: Reverted edits by 131.175.88.93 (talk) to last revision by 23.21.64.122

'''Troubleshooting''' tips from long time Emacs users.
= Locate library file =

; {{Command|locate-library}}
: Use this to debug [[load-path]] issues. Try {{Command|locate-library RET org RET}} now.

I just got this issue but only on ESXi cluster. I chenagd the das.failuredetectiontime value on 4 cluster (1 full ESXi's and 3 full ESX's) and only the ESXi cluster didn't update the value.

= Looking at Emacs Lisp files =

When installing new packages, you would want to hear some words of wisdom from the author of the library file.

; {{Command|find-library}}
: Try {{Command|find-library RET mediawiki RET}} to see whether you have installed [[Mediawiki.el]]. If it works, look at the ''Commentary'' section to see the author's notes.

[[Category:Beginner]][[Category:Intermediate]][[Category:Troubleshoot]]

CSS

2012-06-24T19:47:31Z

Bozhidar: Reverted edits by 94.23.1.28 (talk) to last revision by Francesco

== CSS-mode ==

== Rainbow Mode ==
Wondering what that HTML color code is in your CSS file? Why not highlight it with its corresponding color? Try out [http://julien.danjou.info/software/rainbow-mode rainbow-mode] to do just that!

[[Category:Markup languages]]

Keyboard macros

2012-06-24T19:47:28Z

Bozhidar: Reverted edits by 213.244.10.184 (talk) to last revision by 94.23.1.28

{{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" on every row 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>

I think the exposure looks relaly good with the flash! I am having the hardest time figuring out what is the "right" exposure using my speedlight also. I think this looks great and u got great catchlights, no pinlights. Very sweet post. :)

==Saving macros==
{{Manual|emacs|Save-Keyboard-Macro|Save Keyboard Macro}}

Take a look at the Canon Digital Elph series. I pecikd up a 10MP camera for just under $200 back in November from Amazon.com. They've got newer stuff that's better than what I have, though I love my SD770IS.

===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.

Hi, I just installed this pagkace into Umbraco v4.7. Once I insert the macro into my post I get this error message: Server Error in /' Application.A potentially dangerous Request.Path value was detected from the client (&).Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.Exception Details: System.Web.HttpException: A potentially dangerous Request.Path value was detected from the client (&).Source Error:An unhandled exception was generated during the execution of the current web request. Information regarding the origin and location of the exception can be identified using the exception stack trace below.Stack Trace: However if I go ahead and save/publish the document everything seems to be working just fine. Is there an issue with v4.7 or do I have bigger issues?

Evil

2012-06-24T19:46:54Z

Bozhidar: Reverted edits by 94.23.1.28 (talk) to last revision by Kindahero

'''Evil''' is an '''e'''xtensible '''vi''' '''l'''ayer for Emacs. It provides Vim features like Visual selection and text objects, and is the successor to the now defunct vimpulse and vim-mode.

=== Quick install ===

Using [[el-get]], Evil can be downloaded and installed with: M-x el-get-install RET evil RET.

=== Download ===

Alternatively, Evil lives in a Git repository. To download Evil, do:

git clone git://gitorious.org/evil/evil.git

If you don't have Git, just head over to [https://gitorious.org/evil/evil/commits/master Gitorious] and click the ''"Download master as tar.gz"'' link (extract with ##tar -xzf master.tar.gz##).

=== Install ===

Move Evil to ~/.emacs.d/evil (or somewhere else in your ##load-path##). Then add the following lines to ~/.emacs:

(add-to-list 'load-path "~/.emacs.d/evil")
(require 'evil)
(evil-mode 1)

Evil requires [UndoTree undo-tree.el] in the load-path for linear undo and undo branches. Otherwise, Evil uses regular Emacs undo.

=== Documentation ===

A brief [https://gitorious.org/evil/evil/blobs/raw/doc/doc/evil.pdf PDF manual] is available in the /doc subdirectory.

=== Articles ===

* [http://dnquark.com/blog/2012/02/emacs-evil-ecumenicalism/ Emacs Evil Ecumenicalism]

=== Plug-ins ===

* [https://github.com/timcharper/evil-surround evil-surround]: Port of Vim's surround script.

* [https://github.com/cofi/evil-numbers evil-numbers]: Vim-like increment and decrement.

* [https://github.com/cofi/evil-leader evil-leader]: Port of Vim's mapleader.

[[Category:Vi User]] [[Category:Vim User]]

Installing Emacs on BSD

2012-06-24T19:46:46Z

Bozhidar: Reverted edits by 177.71.188.156 (talk) to last revision by Bozhidar

Emacs is available among BSD variants including FreeBSD, NetBSD, OpenBSD and PC-BSD

== FreeBSD ==

=== Install ===

==== Emacs 23 ====

To install the latest stable version of Emacs, with all the latest features, there are two approaches: using a pre built package or building from the ports.

To fetch and install the package run:

<source lang="text">

# pkg_add -r emacs

</source>

Or use the ports:

<source lang="text">

# cd /usr/ports/editors/emacs

# make install

</source>

==== Emacs 24 ====

To install the latest development version of Emacs, with all the latest features, there are two approaches: using a pre built package or building from the ports.

To fetch and install the package run:

<source lang="text">

# pkg_add -r emacs-devel

</source>

Or use the ports:

<source lang="text">

# cd /usr/ports/editors/emacs-devel

# make install

</source>

=== Related documentation ===
[http://www.freebsd.org/doc/en/books/developers-handbook/emacs.html Using Emacs as a Development Environment] from the official FreeBSD project documentation. Some of the config tweaks are a bit dated and might need updating. But overall it's a good starting point.

== NetBSD ==

== OpenBSD ==

== PC-BSD ==

[[Category:FreeBSD]][[Category:Emacs-24]][[Category:Beginner]][[Category:Install Or Upgrade]]

Main Page

2012-06-24T19:46:45Z

Bozhidar: Reverted edits by 94.23.1.28 (talk) to last revision by 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]]

W3m-el

2012-06-24T19:46:44Z

Bozhidar: Reverted edits by 94.23.1.28 (talk) to last revision by 188.143.232.12

Consider Emacs: it is extremely muaoldr and extremely extensible by virtue of it’s embedded Lisp interpreter. This is a strange thing to say in a paragraph talking about the Unix Philosophy, since Emacs comes from a completely different culture (MIT/ITS/Lisp vs Bell/PDP/C) and is virtually the antithesis of the Unix Way (everything in one process, communicating by function calls with rich data types).I love Emacs as much as anybody, but I wouldn't claim it has anything to do with Unix. We even had a funny name for the Unix port of Emacs ( Gosmacs ) way back when that wasn't the common place to run it!P: Have you ever tried building a medium-large-scale application (say, a project with 50-60 classes) with emacs and gcc? I’m sure it’s possible, with persistence Yes, I'm working on a large system right now not in C, but it has over 600 classes, and I don't know what an IDE could do for me that Emacs can't. find-tag is just as fast with 600 classes as with 6. Macros make O(n) editing tasks into O(1) editing tasks on any size project.What specific feature of an IDE helps you here? Everything I can think of that IDEs brag about, I do in Emacs every day.

Emacs Terminology

2012-06-24T19:46:12Z

Bozhidar: Reverted edits by 97.88.153.202 (talk) to last revision by Kindahero

== Buffer ==
[[File:Emacs_parts.png|320px|thumb|right|different color boxes shows different parts of emacs frame]]
When you use {{Keys|C-x C-f}} to invoke command find-file, Emacs opens the file you request, and puts its contents into
a buffer with the same name as the file. Instead of thinking that you are editing a file, think that you are editing
text in a buffer. When you save the buffer, the file is updated to reflect your edits.

Buffers can also contain text that doesn't come from a file. When you use {{Keys|C-x C-b}} to get a list of buffers,
that list is itself in a buffer, called <tt>*Buffer List*</tt>, and that buffer is not associated with any file.

By convention, buffers whose names start with an asterisk ('''`*'''') are not associated with files (but that doesn't
mean you can't save them in files). If they have unsaved changes when you exit Emacs, these buffers are killed without
your being asking for confirmation.

Buffers whose names start with a space are [[InvisibleBuffers|invisible]] to many operations. These are generally
internal buffers that you don't want to see. Their names normally don't appear in the buffer list or as
[[Completion|completion]] candidates when you switch buffers using {{Keys|C-x b}}.

Buffers are shown in [[#Window|windows]]. You can have more than one window showing the same buffer. {{Keys|C-x 2}}
splits the current window, creating two windows, both showing the same buffer.

You can read more about windows in the Emacs manual:
* {{Manual|emacs|Buffers|Buffers}}
* {{Manual|emacs|Windows|Windows}}

== Window ==

In Emacs terminology, a "window" is a container in which a [[#Buffer|buffer]] is displayed. This may be confusing at first; if so, think "pane" whenever you see "window" in an Emacs context until you get used to it.

A new Emacs [[#Frame|frame]] contains one window. This window can be split in to multiple windows using:
* {{CommandKeys|C-x 2|split-window-below}} - Split the window horizontally to create two stacked windows
* {{CommandKeys|C-x 3|split-window-right}} - Split the window vertically to create two side-by-side windows

You can use multiple windows to view different [[#Buffer|buffers]] (or different portions of the same [[#Buffer|buffer]]) at once.

You can read more about windows in the Emacs manual:
* {{Manual|emacs|Screen|Screen}}
* {{Manual|emacs|Windows|Windows}}

== Frame ==

In Emacs terminology, a "frame" is what most window managers (Windows, OSX, GNOME, KDE, etc.) would call a "window".

It will typically have a title bar and some buttons to iconify (minimize), maximize / restore, and close the frame. To
see an example, open up a second frame from your running Emacs instance with {{CommandKeys|C-x 5 2|make-frame-command}}. You can close frames with {{CommandKeys|C-x 5 0|delete-frame}}, though this
will not close the last frame that is open.

To be completely correct, frames can be created when Emacs is running in terminal mode too, not just in a windowing system. They don't provide the same visual cues but otherwise work the same.

You can read more about frames in the Emacs manual:
* {{Manual|emacs|Screen|Screen}}
* {{Manual|emacs|Frames|Frames}}

== Point ==

The active cursor shows the location at which editing commands will
take effect, which is called "point". Many Emacs commands move
point to different places in the buffer; for example, you can place
point by clicking mouse button 1 (normally the left button) at the
desired location.

If you use a block cursor, the cursor appears to be on a
character, but you should think of point as between two characters;
it points before the character that appears under the cursor. For
example, if your text looks like `frob' with the cursor over the `b',
then point is between the `o' and the `b'. If you insert the character
`!' at that position, the result is `fro!b', with point between the `!'
and the `b'. Thus, the cursor remains over the `b', as before.

Sometimes people speak of "the cursor" when they mean "point," or
speak of commands that move point as "cursor motion" commands.

You can read more about the point in the Emacs manual:
* {{Manual|emacs|Point|Point}}

== The Mark and the Region ==

Many Emacs commands operate on an arbitrary contiguous part of the
current buffer. To specify the text for such a command to operate on,
you set "the mark" at one end of it, and move point to the other end.
The text between point and the mark is called "the region". The region
always extends between point and the mark, no matter which one comes
earlier in the text; each time you move point, the region changes.

You can read more about the mark and the region in the Emacs manual:
* {{Manual|emacs|Mark|Mark}}

== Killing ==

In Emacs, "killing" means erasing text and copying it into the "kill
ring". "Yanking" means bringing text from the kill ring back into the
buffer. (Some applications use the terms "cutting" and "pasting" for
similar operations.) The kill ring is so-named because it can be
visualized as a set of blocks of text arranged in a ring, which you can
access in cyclic order.

You can read more about killing in the Emacs manual:
* {{Manual|emacs|Killing|Killing}}

== Yanking ==

"Yanking" means reinserting text previously killed. The usual way to
move or copy text is to kill it and then yank it elsewhere one or more
times.

You can read more about Yanking in the Emacs manual:
* {{Manual|emacs|Yanking|Yanking}}

== Faces ==

Emacs can display text in several different styles, which are called faces. Each face can specify various face attributes, such as the font, height, weight and slant, the foreground and background color, and underlining or overlining. A face does not have to specify all of these attributes; often it inherits most of them from another face.

On a text-only terminal, not all face attributes are meaningful. Some text-only terminals support inverse video, bold, and underline attributes; some support colors. Text-only terminals generally do not support changing the height, width or font.

Most major modes assign faces to the text automatically through the work of Font Lock mode. See Font Lock, for more information about Font Lock mode and syntactic highlighting. You can print the current buffer with the highlighting that appears on your screen using the command {{Command|ps-print-buffer-with-faces}}.

You can read more about faces in the Emacs manual:
* {{Manual|emacs|Faces|Faces}}

== Major mode ==

Emacs can adapt its behaviour to the specific type of text edited in a buffer. The set of specific Emacs customizations for a particular type of text is called a "major mode". Each buffer has exactly one major mode depending on its content type (but see [[MuMaMo]] for a way to relax this constraint).

Major modes can change the meaning of some keys, define syntax highlighing or indentation rules, and install new key bindings (usually beginning with {{Keys|C-c}}) for mode-specific commands. Emacs ships with a wide range of major modes, falling into three main categories:
* support for text (e.g. [[:Category:Markup languages|markup languages]]),
* support for [[:Category:Programming languages|programming languages]],
* applications within emacs (e.g. [[dired]], [[gnus]], ...). Buffers using this last group of major modes are usually not associated to files, but rather serve as a user interface.

You can read more about major modes in the Emacs manual:
* {{Manual|emacs|Major-Modes|Major Modes}}

== Minor mode ==

Minor modes are optional features that can be turned on and off. Minor modes can be enabled for specific buffers (''buffer-local'' modes) or all buffers (''global'' modes).

Emacs provides lots of minor modes. Just a few examples:

* [[Auto Fill]] mode to automatically [[#Fill]] text as you type.
* [[Flyspell]] mode to highlight spelling errors as you type.
* [[Visual Line]] mode to wrap long lines to fit the screen. (See [[#Screen Lines]])
* [[Transient Mark]] mode to highlight the current region.

You can read more about minor modes in the Emacs manual:
* {{Manual|emacs|Minor-Modes|Minor Modes}}

== Fill ==

In Emacs ''filling'' text means breaking it in to lines of a given maximum width. You can enable automatic filling with {{Command|auto-fill-mode}}, or fill a specific block of text using something like {{CommandKeys|M-q|fill-paragraph}}.

Note that fill commands add hard line breaks to the text. This is different from what might be called "word wrap" (or "line wrap") in other tools, where the text is wrapped at the edge of the current display and re-flowed if the window is resized. Emacs provides this sort of wrapping as well, see [[#Screen Lines]]

You can read about the various ways to fill text in the Emacs manual:
* {{Manual|emacs|Filling|Filling}}

== Screen Lines ==

Emacs provides several ways to deal with text lines that extend horizontally beyond the size of the current window. These are display features: they change the ''screen lines'' shown in the window without modifying the ''logical lines'' of the actual text.

* By default, Emacs wraps a long line of text at the edge of the window and shows the remaining text in ''continuation lines''.
* [[Visual Line]] mode provides what is commonly called "word wrap": long lines are wrapped at the edge of the window without breaking in the middle of a word. Try {{Command|visual-line-mode}}.
* ''Line truncation'' means that text beyond the edge of the display is simply not shown, i.e. the line is cut off. Try {{Command|toggle-truncate-lines}}.

These display options can affect how some editing and movement commands work. Refer to the documentation for details. To reformat text with hard line breaks, see [[#Fill]].

You can read more about the various ways of visualizing long lines in the Emacs manual:
* {{Manual|emacs|Continuation-Lines|Continuation Lines}}
* {{Manual|emacs|Visual-Line-Mode|Visual Line Mode}}
* {{Manual|emacs|Line-Truncation|Line Truncation}}

== case-fold ==

Case '''in'''sensitivity.

== Narrow and widen ==

Sometimes you want to work on just a portion of the current buffer and ignore the rest. Emacs provides commands to ''narrow'' the display so that it only shows the text you are interested in. Text outside of the current ''restriction'' is hidden from view and inaccessible to editing commands.

Use {{CommandKeys|C-x n n|narrow-to-region}} to narrow the display to the current region. Use {{CommandKeys|C-x n w|widen}} to ''widen'' the display, making the entire buffer accessible again.

Note that narrowing can be confusing to new users, so the command <tt>narrow-to-region</tt> is disabled by default. If you have not explicitly enabled this command before trying to use it, you will be prompted to do so.

Narrowing can be considered an alternative to collapsing blocks of text (folding). Narrowing allows you to identify a block of text to edit, whereas folding allows you to identify a block of text to hide. Emacs has various ways to hide text (see [[#Selective Display]]). The key difference between hiding text and narrowing is that hidden text remains editable: you can still delete a block of text that has been collapsed from view. With a narrowing restriction, only the active text can be modified.

You can read more about narrowing and other ways to hide text in the Emacs manual:
* {{Manual|emacs|Narrowing|Narrowing}}

== Selective Display ==

Emacs provides a way to hide lines of text indented more than a given number of columns:
{{Command|set-selective-display}}, bound to {{Keys|C-x $}} by default.

This can be useful to hide "details" and get an overview of a file that uses indentation in some meaningful way (like most programming langauges). Note that the hidden text remains editable; see [[#Narrowing]] for a safer way to edit a specific portion of a buffer.

There are a variety of other ways to hide text in an Emacs buffer, such as [[Outline]] and [[Hideshow]] modes.

You can read more about selective display in the Emacs manual:
* {{Manual|emacs|Selective-Display|Selective Display}}

[[Category:Beginner]]

== font-lock ==

Syntax highlighting.

[[Category:Key Concepts]] [[Category:Emacs Terminology]] [[Category:Beginner]]

Template:Documentation/end box2

2012-06-24T19:46:11Z

Bozhidar: Reverted edits by 88.127.240.128 (talk) to last revision by Bozhidar

{{documentation/end box
| preload = {{{preload|}}} 
| content = {{{content|}}}
| link box = {{{link box|}}} 

| docpage =
{{#if: {{{1|}}}
| {{{1|}}}
| {{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/doc
}}
| doc exist =
{{#ifexist:
{{#if: {{{1|}}}
| {{{1|}}} 
| {{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/doc
}}
| yes
}}
| docname fed =
{{#if: {{{1|}}}
| yes
}}

| sandbox =
{{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/sandbox
| testcases =
{{{docspace|{{NAMESPACE}}}}}:{{{template page|{{PAGENAME}}}}}/testcases

| template page =
{{NAMESPACE}}:{{{template page|{{PAGENAME}}}}}

}}<noinclude>

{{pp-template}}

</noinclude>

Emacs Lisp Cookbook

2012-06-24T19:44:48Z

Bozhidar: Reverted edits by 174.137.184.37 (talk) to last revision by 88.55.116.18

This page contains snippets of code that demonstrate basic [[Emacs Lisp]]
programming operations in the spirit of O'Reilly's Cookbook
series of books. For every task addressed, a worked-out solution
is presented as a short, focused, directly usable piece of code.

All this stuff can be found elsewhere, but it is scattered about in
libraries, manuals, etc. It would be helpful to have it here in one
spot.

These recipes should be pastable into the '''*scratch*''' buffer so that
users can hit '''C-j''' and evaluate them step by step.

== Strings ==

The empty string (zero-length string, null string, ...):

<syntaxhighlight lang="lisp">
(zerop (string-match "" "")) ;; O(n)
==> t

(string-equal "" "") ;; O(n)?
==> t

(equal "" "") ;; O(n)?
==> t

(zerop (length "")) ;; O(1)
==> t

(eq "" "") ;; O(1)
==> t
</syntaxhighlight>

As a space and performance optimization, Emacs keeps an intern-ed copy
of the empty string as a single object

<syntaxhighlight lang="lisp">
(eq "" (purecopy ""))
==> t

(eq "" (propertize "" 'face 'italic))
==> t
</syntaxhighlight>

=== Strings vs buffer content ===

While it is quite common in other programming languages to work on
strings contained in variables in Emacs it is even more idiomatic to
work on strings in buffers. That's why the following contains examples
of both.

Just found in my email's sent item. Nicolas is the head of IT of UK office:=================================Re : Qubee Service in BangladeshDear Nicolas Ruelle:Greeting!I would be glad if you take some of your time and go thugroh my email. This is regards to the internet service you are providing in Bangladesh. Since I failed to get the contact email address of head of IT or some upper management of Qubee Bangladesh I had no choice but take this opportunity to write you few words of mine.In order for me to work to my remote office in Canada I needed a true reliable consumer/business high speed internet which I did not find until I learned about Qubee's WiMax as I believe wireless is the reliable link among others when it comes to Bangladesh.Incident 1:Since I started the Qubee service on 2nd week of January with 512kbs it was satisfactory with the speed accept for the VPN issue that started to occur from the day one. I was able to dial in the VPN and connect but was not able to communicate with any of the servers within the LAN, I had done some checks with other ISPs and found no issues which satisfied me that it was either the WiMax Router/Modem or the ISP's router. I called the customer care number wanted to speak to someone from the technical support. Customer care asked me provide her with the problem and so did I. Unfortunately the individual had no clear picture about VPN but asked me to check download speed, radio's parameter, and all the basic things that not related to the issue I had specified. At the end I had to introduce myself as an advance user and a technical person and asked her if I could speak to someone from the technical support. She created ticket for it and informed me that someone will get back to me soon. 36 hours past no one contacted me and I had to call the customer care number to follow up with my ticket. Few hours later I had a phone call from some individual and I had to describe the issue and I was asked to check the speed and other non-related VPN checks. It was frustrating. I beged to speak to someone who is familiar with the VPN and its usage. Next day I had a phone call from the customer care and told me that there was no issues from Qubee end but the VPN provider or my PC so I had to fight against the customer care's word. Few days later I received a call from Qubee and asking for my VPN credential for them to test from their office which surprised me big time. I refused and offered myself with my laptop at Qubee's office. I went there to prove that it is the Qubee not the VPN provider by connecting via other ISP's Edge Modem. They started tracing finally and at a point I had to ask them to test my laptop with a public IP assigned and it went successful. The issue was resolved by assigning a public IP address as all the Qubee modems are assigned with private 10.11. network.Incident 2:A week ago around 7 PM local time my internet link went down all of sudden. After investing I found it was about 70-90% packet loss to some hosts including Google and Qubee's local DNS server. I called the customer care number after my further investigation to make sure my end was good. The customer care individual wanted to me access my PC to troubleshoot and take some reports on the modem. Unfortunately I was unable to explain to her that it was not possible for her get into PC due to network issue. I was surprised that she claimed to be technical without knowing about ping utility and packet loss terms. She also did not have idea about pinging between their DNS name and my end or how it works. I requested to talk to someone from technical team, we have to follow our procedure and some will visit your premises tomorrow , she replied. I knew that the issue may recover next day or later by itself but I needed support at that particular time as I was in the middle of my regular remote work. At the end I had to forget about hoping and use my backup internet (real slow) to report the office about my unavailability for that evening (imagine if I had no backup internet).Next morning everything was resolved by itself, I suspect there were some issues within the base station during the incident period. I had a visitor from Qubee's third party support to check my modem and some of the numbers of it after 3 days. He found nothing or could not do anything but took some snapshots with him. Note: issue resolved by it self. Imagine you were down for three days and no followups were made. Next day I had another phone call from Qubee's third party contractor to schedule a time to visit my place regarding the ticket Download/upload Issue . Note the ticket description as I specifically asked her to put packet loss somewhere in the ticket. I had to tell him everything was fine, no issues.Summary:I would like Qubee to put extra attention to be a modern and standard internet service provider in Bangladesh. As a subscriber I would like to see the following in Qubee. * Valuing customers by listening and understanding their specific problems and the needs (should be one them on the top) * A 24/7 true technical support team with basic troubleshooting skills set. * An escalation procedure should be implemented as well so customers are in touch in time (no 3 days waiting periods). * Understanding the terms Customer Care and Technical Support and implementation of it. * Response time and proper follow up manner. * Downtime notifications in advance * Responding emails with their inquiries. (I never received one) * Plug-n-play account activation system, where customer will be able to activate their unit on their own after purchasing the box from the outlet so installation engineer is required to visit the customer premises.Thank you!================Reply received after 30 minutes:================Dear Sayeed,Thank you very much for this valuable input. I am forwarding it immediately to the appropriate managers at Qubee Bangladesh: the head of customer care and the head of IT.Best regards,Nicolas Ruelle============I believe it never helped.

=== Processing characters ===

Reversing a string:

<syntaxhighlight lang="lisp">
(string-to-list "foo")
==> (102 111 111)
(reverse (string-to-list "foo"))
==> (111 111 102)
(apply 'string (reverse (string-to-list "foo")))
==> "oof"
</syntaxhighlight>

See CharacterProcessing and StringModification. See [[tr]] for an example of you sometimes need to mix strings and characters.

Looking at characters in buffers:

<syntaxhighlight lang="lisp">
(with-temp-buffer
(insert "abcdefg")
(goto-char (point-min))
(while (not (= (char-after) ?b))
(forward-char))
(point))
==> 2
</syntaxhighlight>

=== Trim whitespace ===

Trim whitespace from the end of a string:

<syntaxhighlight lang="lisp">
(setq test-str "abcdefg ")
(when (string-match "[ \t]*$" test-str)
(message (concat "[" (replace-match "" nil nil test-str) "]")))
</syntaxhighlight>

Trim whitespace from a string with a Perl-like chomp function:

<syntaxhighlight lang="lisp">
(defun chomp (str)
"Chomp leading and tailing whitespace from STR."
(while (string-match "\\`\n+\\|^\\s-+\\|\\s-+$\\|\n+\\'"
str)
(setq str (replace-match "" t t str)))
str)
</syntaxhighlight>

=== Splitting strings ===

The 'split-string' function is defined in 'subr.el' as

<source lang="lisp">
(defun split-string (string &optional separators omit-nulls)
...)
</source>

where 'separators' is a regular expression describing where to split the string. 'separators' defaults to white-space characters (spaces, form feeds, tabs, newlines, carriage returns, and vertical tabs). If 'omit-nulls' is set as 't' then zero-length strings are deleted from output.

<source lang="lisp">
(split-string "1 thing 2 say 3 words 4 you" "[1-9]")
==> ("" " thing " " say " " words " " you")
</source>

Omitting nulls:
<source lang="lisp">
(split-string "1 thing 2 say 3 words 4 you" "[1-9]" t)
(" thing " " say " " words " " you")
</source>

=== Joining strings ===

Use `mapconcat' to join a list into a string using a separator ("glue") between elements in the string.

Example:

<syntaxhighlight lang="lisp">
(mapconcat 'identity '("" "home" "alex " "elisp" "erc") "/")
==> "/home/alex /elisp/erc"
</syntaxhighlight>

=== Serialization ===

The basic idea is to convert forms to strings with `prin1-to-string' and convert it back from a string with `read'.

<syntaxhighlight lang="lisp">
(length (read (prin1-to-string (make-list 1000000 '(x)))))
==> 1000000

(read (prin1-to-string "Hello World!"))
==> "Hello World!"
</syntaxhighlight>

This only works in the simplest cases. Unfortunately, this doesn't work for all Emacs data types for programming or the editor.

<syntaxhighlight lang="lisp">
(read (prin1-to-string (make-hash-table))) ;; Error before Emacs 23.
==> #s(hash-table size 65 test eql rehash-size 1.5 [...] data ())

(read (prin1-to-string (current-buffer)))
==> Lisp error: (invalid-read-syntax "#")
</syntaxhighlight>

=== Formatting ===

== Killing text ==

As the Emacs Lisp Manual says, "Most of the kill commands are primarily for
interactive use [...] When you need to delete text for internal
purposes within a Lisp function, you should normally use deletion
functions, so as not to disturb the kill ring contents."

The following mimic the `kill-' commands but without disturbing the kill ring.

=== Delete region ===

The Lisp equivalent of `kill-region' (`C-w') but without kill ring side effects::

<syntaxhighlight lang="lisp">
(delete-region (region-beginning) (region-end))
</syntaxhighlight>

According to the ElispManual, "Few programs need to use the
`region-beginning' and `region-end' functions." This is because
Lisp code should not rely on nor "alter the mark unless altering
the mark is part of the user-level functionality of the
command. (And, in that case, this effect should be documented.)
To remember a location for internal use in the Lisp program,
store it in a Lisp variable. For example: [...]"

<syntaxhighlight lang="lisp">
(let ((beg (point)))
(forward-line 1)
(delete-region beg (point)))
</syntaxhighlight>

=== Delete line ===

The equivalent of `kill-line' (`C-k') but without kill ring side effects:

<syntaxhighlight lang="lisp">
(let ((beg (point)))
(forward-line 1)
(forward-char -1)
(delete-region beg (point)))
</syntaxhighlight>

Alternatively, replacing the `let' with `save-excursion'.

<syntaxhighlight lang="lisp">
(delete-region (point)
(save-excursion
(forward-line 1)
(forward-char -1)
(point)))
</syntaxhighlight>

Or simplest of all,

<syntaxhighlight lang="lisp">
(delete-region (point) (line-end-position))
</syntaxhighlight>

The examples with `forward-line' are shown because the paradigm is used later, see below.

=== Delete line backwards ===

The equivalent of killing the line backwards (`C-0 C-k') but without kill ring side effects:

<syntaxhighlight lang="lisp">
(let ((beg (point)))
(forward-line 0)
(delete-region (point) beg))
</syntaxhighlight>

Alternatively, replacing the `let' with `save-excursion'.

<syntaxhighlight lang="lisp">
(delete-region (save-excursion
(forward-line 0)
(point))
(point))
</syntaxhighlight>

Or simplest of all,

<syntaxhighlight lang="lisp">
(delete-region (line-beginning-position) (point))
</syntaxhighlight>

=== Delete line to next line ===

The equivalent of killing the line and the newline (`C-1 C-k') but without kill ring side effects:

<syntaxhighlight lang="lisp">
(let ((beg (point)))
(forward-line 1)
(delete-region beg (point)))
</syntaxhighlight>

Alternatively, replacing the `let' with `save-excursion'.

<syntaxhighlight lang="lisp">
(delete-region (point)
(save-excursion
(forward-line 1)
(point)))
</syntaxhighlight>

=== Delete whole line ===

The equivalent of `kill-whole-line' (`C-S-DEL') but without kill ring side effects:

<syntaxhighlight lang="lisp">
(let ((beg (progn (forward-line 0)
(point))))
(forward-line 1)
(delete-region beg (point)))
</syntaxhighlight>

Alternatively, replacing the `let' with `save-excursion'.

<syntaxhighlight lang="lisp">
(delete-region (save-excursion
(forward-line 0)
(point))
(save-excursion
(forward-line 1)
(point)))
</syntaxhighlight>

Or simplest of all,

<syntaxhighlight lang="lisp">
(delete-region (line-beginning-position) (line-end-position))
</syntaxhighlight>

=== Delete word ===

The equivalent of `kill-word' (`M-d') but without kill ring side effects:

<syntaxhighlight lang="lisp">
(let ((beg (point)))
(forward-word 1)
(delete-region beg (point)))
</syntaxhighlight>

Alternatively, replacing the `let' with `save-excursion'.

<syntaxhighlight lang="lisp">
(delete-region (point)
(save-excursion
(forward-word 1)
(point)))
</syntaxhighlight>

=== Delete sentence ===

The equivalent of `kill-sentence' (`M-k') but without kill ring side effects:

<syntaxhighlight lang="lisp">
(let ((beg (point)))
(forward-sentence 1)
(delete-region beg (point)))
</syntaxhighlight>

Alternatively, replacing the `let' with `save-excursion'.

<syntaxhighlight lang="lisp">
(delete-region (point)
(save-excursion
(forward-sentence 1)
(point)))
</syntaxhighlight>

Забавно!недавно был очень похожий случай.есть функция:string addsign(char sign, const srnitg & s){1) return sign+s; // так нельзя2) return srnitg(s1)+s; //тоже нельзя3) return srnitg(s1, 1)+s;// только так можно... но блин не сразу допетриваешь }Решил это сам проверить, на компиляторе gcc 3.4.2.вот такая программулинка:#include <string>#include <stdio.h>using namespace std;string addsign(char s1, const srnitg & s){//1)return s1+s; // так нельзя//2)return srnitg(s1)+s; //тоже нельзя//3)return srnitg(s1, 1)+s;// только так можно... но блин не сразу допетриваешь//4)return srnitg(&s1, 1)+s;}int main(int n, char **args){ srnitg text = "1.9876"; srnitg res = addsign('-', text); puts(res.c_str()); return 0;}выдала мне срвсем другое:первый вариант (как "нельзя") выдал правильный результат: -1.9876, второй вариант - ошибку компиляции, а третий(который "только так и можно") дал нечто невразумительное - кучу смеющихся рожиц и в конце-число 1.9876. Мне даже непонятно, как у автора сообщения получился нормальный результат.Последний (4-ый, "мой" вариант) дал тоже верный результат: -1.9876

== Dates and times ==

=== Get today's date ===

<syntaxhighlight lang="lisp">
(format-time-string "%d %B %Y")
</syntaxhighlight>

or

<syntaxhighlight lang="lisp">
(eshell/date)
</syntaxhighlight>

I discovered Emacs in '97 when I was doing C++ depnmovleet for BellSouth (the Sun depnmovleet tools had great integration with either vi, Emacs or XEmacs editors). I'd been a hardcore vi user since 1990 (still am), but I could adapt Emacs (actually, for some reason I opted for XEmacs at the time can't remember why maybe it had better fonts) better for the job at hand. Syntax highlighting check (vi never had this it only arrived with vim), split buffers (top for the .h, bottom for the .cpp) check, tab completion for finding files check, nice macro record/playback features check, nice search/replace check,control behavior of tab key check, auto replace tabs with 4 spaces check. So, after a while you can imagine I crafted a pretty customized/personal .emacs file. I even continued to use emacs for a while after switching to Java in 2000 (it wasn't until Eclipse 2.0 before I switched to an IDE and left Emacs behind).Then I moved on, and for some reason the .emacs file got left behind. Shame really I haven't really used Emacs since it's not the same without my .emacs file and I don't have the time or inclination to re-create it.

=== Conversions ===

Read a date from a string.

<syntaxhighlight lang="lisp">
(let ((time (date-to-time "Tue, 27-Sep-83 12:35:59 EST")))
(set-time-zone-rule t) ;; Use Universal time.
(prog1 (format-time-string "%Y-%m-%d %T UTC" time)
(set-time-zone-rule nil))) ;; Reset to default time zone.
==> "1983-09-27 17:35:59 UTC"
</syntaxhighlight>

Decode a time object.

<syntaxhighlight lang="lisp">
(decode-time (date-to-time "Tue, 27-Sep-83 12:35:59 EST"))
==> (59 35 13 27 9 1983 2 t -14400)
</syntaxhighlight>

Get the seconds from the unix epoch.

<syntaxhighlight lang="lisp">
(let ((time (date-to-time "13 Feb 2009 23:31:30 UTC")))
(float-time time))
==> 1234585890.0
</syntaxhighlight>

Find the date for seconds from the unix epoch.

<syntaxhighlight lang="lisp">
(format-time-string "%Y-%m-%d %T UTC" (seconds-to-time 1234585890))
==> "2009-02-13 23:31:30 UTC"
</syntaxhighlight>

Find the date 30 seconds in the future.

<syntaxhighlight lang="lisp">
(format-time-string "%Y-%m-%d %T UTC" (time-add (current-time)
(seconds-to-time 30)))
==> "2012-02-13 10:07:11 UTC"
</syntaxhighlight>

Formatting elapsed time in years, days, hours, minutes and seconds.

<syntaxhighlight lang="lisp">
(format-seconds "%Y %D %h:%m:%s" (1- (* 367 24 3600)))
==> "1 year 1 day 23:59:59"
</syntaxhighlight>

Find the days between two dates.

<syntaxhighlight lang="lisp">
(let ((days1 (time-to-days (date-to-time "Tue, 27-Sep-83 12:35:59 EST")))
(days2 (time-to-days (date-to-time "2009-02-13 23:31:30 UTC"))))
(- days2 days1))
==> 9271
</syntaxhighlight>

Getting the day in the year.

<syntaxhighlight lang="lisp">
(time-to-day-in-year (current-time))
==> 44
</syntaxhighlight>

Build a date based on the day of the year.

<syntaxhighlight lang="lisp">
(format-time-string "%j"
(encode-time 0 0 0 44 1 2012))
==> "044"
</syntaxhighlight>

=== Timers ===

TODO

Its funny that your example uses std::string beaucse it has the solution you're looking for.What you're trying to do is initialize a class member before initializing the base class, and you found that you can't. The typical way to get around this is to abandon hope of extending Foo and implement the wrapper in terms of Foo. (has-a vs. is-a) This solution has the annoyance of you needing to redeclare each and every method you want to use and then forwarding those calls to Foo, and you won't be able to use a FooWrapper in place of a Foo as well, meaning you may need to change a ton of references in your code. However, all you have to do is have FooWrapper expose its underlying Foo and you're good. (kinda like what string::c_str() does)Check out your copy of Effective C++. From the TOC I think item 40 discusses this.

== Sequences ==

Datatypes used to represent sequences of things:

_____________________________________________
| |
| Sequence |
| ______ ________________________________ |
| | | | | |
| | List | | Array | |
| | | | ________ ________ | |
| |______| | | | | | | |
| | | Vector | | String | | |
| | |________| |________| | |
| | ____________ _____________ | |
| | | | | | | |
| | | Char-table | | Bool-vector | | |
| | |____________| |_____________| | |
| |________________________________| |
|_____________________________________________|

=== Lists ===

List basics are explained on ListStructure.
Lists can shrink and grow, but access to elements towards the end of the list is slow if the list is long.

Use `cons' to append a new element to the front of a list.
Use `nth' to access an element of the list.

<syntaxhighlight lang="lisp">
(let ((words '("fight" "foo" "for" "food!")))
(when (string= "foo" (nth 1 words))
(setq words (cons "bar" words)))
words)
==> ("bar" "fight" "foo" "for" "food!")
</syntaxhighlight>

See ListModification for more ways of changing a list.

Iteration:

<syntaxhighlight lang="lisp">
(let ((result))
(dolist (word '("fight" "foo" "for" "food!"))
(when (string-match "o" word)
(setq result (cons word result))))
(nreverse result))
==> ("foo" "for" "food!")
</syntaxhighlight>

Note how `cons' adds an element to the front of the list,
so that usually the list has to be reversed after the loop.
`nreverse' is particularly efficient because it does this
destructively by swiveling pointers around. See
DestructiveOperations for more about this.

Copying:

Use `copy-sequence' to make a copy of a list that won't change the
elements of the original.

<syntaxhighlight lang="lisp">
(let* ((orig '((1 2) (3 4)))
(copy (copy-sequence orig)))
(setcdr copy '((5 6)))
(list orig copy))
==> (((1 2) (3 4)) ((1 2) (5 6)))
</syntaxhighlight>

However, the elements in the copy are still from the original.

<syntaxhighlight lang="lisp">
(let* ((orig '((1 2) (3 4)))
(copy (copy-sequence orig)))
(setcdr (cadr copy) '(0))
(list orig copy))
==> (((1 2) (3 0)) ((1 2) (3 0)))
</syntaxhighlight>

The function `copy-tree' is the recursive version of `copy-sequence'.

<syntaxhighlight lang="lisp">
(let* ((orig '((1 2) (3 4)))
(copy (copy-tree orig)))
(setcdr (cadr copy) '(0))
(list orig copy))
==> (((1 2) (3 4)) ((1 2) (3 0)))
</syntaxhighlight>

Filtering:

Emacs Lisp doesn't come with a `filter' function to keep elements that satisfy a conditional and excise the elements that do not satisfy it. One can use `mapcar' to iterate over a list with a conditional, and then use `delq' to remove the `nil' values.

<syntaxhighlight lang="lisp">
(defun my-filter (condp lst)
(delq nil
(mapcar (lambda (x) (and (funcall condp x) x)) lst)))
</syntaxhighlight>

Therefore,

<syntaxhighlight lang="lisp">
(my-filter 'identity my-list)
</syntaxhighlight>

is equivalent to

<syntaxhighlight lang="lisp">
(delq nil my-list)
</syntaxhighlight>

For example:

<syntaxhighlight lang="lisp">
(let ((num-list '(1 'a 2 "nil" 3 nil 4)))
(my-filter 'numberp num-list))
==> (1 2 3 4)
</syntaxhighlight>

Actually the package cl-seq contains the functions `remove-if' and `remove-if-not'. The latter can be used instead of `my-filter'.

<syntaxhighlight lang="lisp">
(let ((num-list '(1 'a 2 "nil" 3 nil 4)))
(remove-if-not 'numberp num-list))
==> (1 2 3 4)

(let ((num-list '(1 'a 2 "nil" 3 nil 4)))
(remove-if 'numberp num-list))
==> ((quote a) "nil" nil)
</syntaxhighlight>

As an example here is the quick sort algorithm:

<syntaxhighlight lang="lisp">
(defun quicksort (lst)
"Implement the quicksort algorithm."
(if (null lst) nil
(let* ((spl (car lst))
(rst (cdr lst))
(smalp (lambda (x)
(< x spl))))
(append (quicksort (remove-if-not smalp rst))
(list spl)
(quicksort (remove-if smalp rst))))))

(quicksort '(5 7 1 3 -9 8 7 -4 0))
==> (-9 -4 0 1 3 5 7 7 8)
</syntaxhighlight>

Tranposing:

Convert multiple lists into a list

<syntaxhighlight lang="lisp">
((lambda (&rest args)
(mapcar (lambda (n)
(delq nil (mapcar (lambda (arg) (nth n arg)) args)))
(number-sequence 0 (1- (apply 'max (mapcar 'length args))))))
'(1 2 3) '(a b c) '(A B C))
==> ((1 a A) (2 b B) (3 c C))
</syntaxhighlight>

A more concise version is possible with the the higher-arity version of mapcar available with the `cl' library.

<syntaxhighlight lang="lisp">
((lambda (&rest args)
(apply (function mapcar*) (function list) args))
'(1 2 3) '(a b c) '(A B C))
==> ((1 a A) (2 b B) (3 c C))
</syntaxhighlight>

Searching:

Simply checking for existence of a value in a list can be done with
`member' or `memq'.

<syntaxhighlight lang="lisp">
(let ((words '("fight" "foo" "for" "food!")))
(car (member "for" words)))
==> "for"

(let ((re "\\wo\\b")
(words '("fight" "foo" "for" "food!")))
(consp (memq t
(mapcar (lambda (s) (numberp (string-match re s))) words))))
==> t
</syntaxhighlight>

In the latter, a more efficient algorithm would use a loop (a non-local exit).

I don't think so. Normally you will open it up with latest veorisn, then save it in an earlier veorisn, that wat you can retain the 2008 veorisn with all the new options, and then convert it to an earlier. The improvements which are not handled by an earlier veorisn will be prompted when you try to save. You can lose layers or part of layers.

=== Vectors ===

Vectors are fixed in size but elements can be accessed in constant time.

<syntaxhighlight lang="lisp">
(let ((words ["fight" "foo" "for" "food!"]))
(when (string= "foo" (aref words 1))
(aset words 1 "bar"))
words)
==> ["fight" "bar" "for" "food!"]
</syntaxhighlight>

== Hashes ==

Hashes map keys to values. In a way they are similar to alists, except
they are more efficient for a large number of keys.

More info is available on the HashMap page.

=== Storing and retrieving keys and values ===

By default, hash tables use `eql' to compare keys. This is not appropriate
for strings: ##(eql "alex" "alex")## ==> nil. Thus, use `equal' in these cases:

<syntaxhighlight lang="lisp">
(let ((nick-table (make-hash-table :test 'equal)))
(puthash "kensanata" "Alex Schroeder" nick-table)
(gethash "kensanata" nick-table))
==> "Alex Schroeder"
</syntaxhighlight>

Iterate:

<syntaxhighlight lang="lisp">
(let ((nick-table (make-hash-table :test 'equal))
nicks)
(puthash "kensanata" "Alex Schroeder" nick-table)
(puthash "e1f" "Luis Fernandes" nick-table)
(puthash "pjb" "Pascal J. Bourguignon" nick-table)
(maphash (lambda (nick real-name)
(setq nicks (cons nick nicks)))
nick-table)
nicks)
==> ("pjb" "e1f" "kensanata")
</syntaxhighlight>

=== Sorting keys ===

Use `maphash' to build up a list of keys, sort it, and then loop through
the list:

<syntaxhighlight lang="lisp">
(let ((nick-table (make-hash-table :test 'equal))
nicks)
(puthash "kensanata" "Alex Schroeder" nick-table)
(puthash "e1f" "Luis Fernandes" nick-table)
(puthash "pjb" "Pascal J. Bourguignon" nick-table)
(maphash (lambda (nick real-name)
(setq nicks (cons nick nicks)))
nick-table)
(mapcar (lambda (nick)
(concat nick " => " (gethash nick nick-table)))
(sort nicks 'string<)))
==> ("e1f => Luis Fernandes"
"kensanata => Alex Schroeder"
"pjb => Pascal J. Bourguignon")
</syntaxhighlight>

== Files ==

=== Read ===

Processing a file is usually done with a temporary buffer:

<syntaxhighlight lang="lisp">
(defun process-file (file)
"Read the contents of a file into a temp buffer and then do
something there."
(when (file-readable-p file)
(with-temp-buffer
(insert-file-contents file)
(goto-char (point-min))
(while (not (eobp))
;; do something here with buffer content
(forward-line)))))
</syntaxhighlight>

On the chance that a buffer may already be actively visiting the file,
consider using `find-file-noselect'

<syntaxhighlight lang="lisp">
(defun file-string (file)
"Read the contents of a file and return as a string."
(with-current-buffer (find-file-noselect file)
(buffer-string)))
</syntaxhighlight>

=== Write ===

To write something to a file you can create a temporary buffer, insert the things to write there and write the buffer contents to a file. The following example read a string and a filename (with completion, but doesn't need to exist, see InteractiveCodeChar F) and write the string to that file.

<syntaxhighlight lang="lisp">
(defun write-string-to-file (string file)
(interactive "sEnter the string: \nFFile to save to: ")
(with-temp-buffer
(insert string)
(when (file-writable-p file)
(write-region (point-min)
(point-max)
file))))
</syntaxhighlight>

Maybe you are interested in word-count.el. It's cnirately to much foryour use-case but it is a great tool if you have some target lengthfor a document (e.g. diary entries).What I'm really missing in Emacs is some usage statistics. I canalready get an overview over my keybind habits with keyfreq but Iwould like that to be more comprehensive. Average buffer-length, timespent in different modes, time spent in files that are part of acertain directory, lines added etc. Maybe I'm just addicted to lifestatistics and this is not really useful. Who knows.

=== Searching ===

If you don't have grep, then you may need to write some Lisp which can find a match in a file.

<syntaxhighlight lang="lisp">
;; Visit file unless its already open.
(with-current-buffer (find-file-noselect "~/.emacs")
(save-excursion ;; Don't change location of point.
(goto-char (point-min)) ;; From the beginning...
(if (re-search-forward ".*load-path.*" nil t 1)
(match-string-no-properties 0)
(error "Search failed"))))
==> "(add-to-list 'load-path \"/usr/share/emacs/site-lisp/\")"
</syntaxhighlight>

=== Filter ===

=== Locking ===

=== Stat ===

An interface to the kernel's stat(2) is provided by the function file-attributes. The way times are represented may be a bit unexpected, though.

=== Deleting ===

<syntaxhighlight lang="lisp">
(if (file-exists-p filename)
(delete-file filename))
</syntaxhighlight>

=== Copy, move and rename ===

== Directories ==

=== Traversing ===

<syntaxhighlight lang="lisp">
(defun walk-path (dir action)
"walk DIR executing ACTION with (dir file)"
(cond ((file-directory-p dir)
(or (char-equal ?/ (aref dir(1- (length dir))))
(setq dir (file-name-as-directory dir)))
(let ((lst (directory-files dir nil nil t))
fullname file)
(while lst
(setq file (car lst))
(setq lst (cdr lst))
(cond ((member file '("." "..")))
(t
(and (funcall action dir file)
(setq fullname (concat dir file))
(file-directory-p fullname)
(walk-path fullname action)))))))
(t
(funcall action
(file-name-directory dir)
(file-name-nondirectory dir)))))

(defun walk-path-visitor (dir file)
"Called by walk-path for each file found"
(message (concat dir file)))

(walk-path "~/" 'walk-path-visitor)
</syntaxhighlight>

=== Path splitting ===

Splitting the path can be done with `split-string' and with the slash. Previously, Emacs would determine the character separating directory names with `directory-sep-char'. However, the variable is obselete with Emacs 21.1.

<syntaxhighlight lang="lisp">
(split-string default-directory "/")
==> ("" "usr" "share" "emacs" "22.2" "lisp" "")
</syntaxhighlight>

For splitting a path variable, Emacs already has the `parse-colon-path' function.

<syntaxhighlight lang="lisp">
(parse-colon-path (getenv "PATH"))
==> ("/usr/lib/qt-3.3/bin/" "/usr/kerberos/bin/" "/usr/local/bin/"
"/usr/bin/" "/bin/" "/usr/local/sbin/" "/usr/sbin/" "/sbin/")
</syntaxhighlight>

== Processes ==

=== Running a program ===

Run a command without caring about its output.

<syntaxhighlight lang="lisp">
(async-shell-command "emacs")
</syntaxhighlight>

Run a command and put its output in the current buffer.

<syntaxhighlight lang="lisp">
(shell-command "seq 8 12 | sort" t)
10
11
12
8
9
</syntaxhighlight>

Run a command and put its output in a new buffer.

<syntaxhighlight lang="lisp">
(shell-command "seq 8 12 | sort"
(get-buffer-create "*Standard output*"))
</syntaxhighlight>

Run a command return its output as a string.

<syntaxhighlight lang="lisp">
(shell-command-to-string "seq 8 12 | sort")
</syntaxhighlight>

XEmacs also comes with `exec-to-string'.

=== Handling signals ===

== Sockets ==

=== Tcp client ===

=== Tcp server ===

Perhaps EmacsEchoServer and EmacsDaytimeServer can be useful here.

== Keyboard events ==

* Call function bound to key

<syntaxhighlight lang="lisp">
(funcall (key-binding (kbd "M-TAB")))
</syntaxhighlight>

or

<syntaxhighlight lang="lisp">
(call-interactively (key-binding (kbd "M-TAB")))
</syntaxhighlight>

[[Category:Customization]]
[[Category:Intermediate]]

Version Control

2012-06-24T19:44:29Z

Bozhidar: Reverted edits by 94.23.1.28 (talk) to last revision by GregLucas

== Distributed Version Control ==
Emacs provides {{ModeLink|dvc}}, a standard interface for Distributed Version Control systems. {{Mode|dvc}} is based on and largely compatible with {{ModeLink|vc}} (see below).

For some popular distributed version control systems there also exist additional Emacs modes that are independent of {{Mode|dvc}}. These are noted in the table below.

{| class="wikitable"
!System
!Modes
|-
|git
|{{Mode|dvc}}, {{ModeLink|magit}}, <tt>[https://github.com/byplayer/egg egg]</tt>
|-
|Bazaar (bzr)
|{{Mode|dvc}}
|-
|Mercurial (hg)
|{{Mode|dvc}}
|}

== Conventional Version Control ==
[[vc]] provides a standard interface between Emacs and conventional version control systems. See the table for an overview.
{| class="wikitable"
!System
!Modes
|-
|CVS
|{{Mode|vc}}
|-
|SVN
|{{Mode|vc}}
|-
|RCS
|{{Mode|vc}}
|}

== See Also ==
[[Magit]]
[[Egg]]

[[Category:Programming]]
[[Category:Text Editing]]
[[Category:Version Control]]

Bookmarks

2012-06-24T19:43:12Z

Bozhidar: Reverted edits by Bozhidar (talk) to last revision by 218.108.168.170

It's a push press not a strict press. Done pelrrpoy, there shouldn't be a lot of strain put on your neck because your shoulders and traps don't do much for the first 1/3rd of the press. Try it and you'll see what I mean. This exercise is responsible for a lot of pro strongmen and olympic lifters developing ungodly shoulder strength. Way different than press/push press from rack position.

Bookmarks

2012-06-24T19:42:17Z

Bozhidar: Reverted edits by 218.108.168.170 (talk) to last revision by 188.143.232.12

try a vegeterian diet, it helps get rid of fat, bulk.avoid salts. you still can have portein just notfrom meat. try fish if you have to get portein.other than that, any kind of stop, and jumps, repeatedwill help build the muscles you need. do it for 20 minutesever other day. you need to give it time to recover.you may want to increate the 30 minutes of jumpingto 40 once you see improved jumping.Play lots of basketballIf you play a lot of ball, that will tranlate into being in better shape. There's no way your vertical leap will improve if you aren't in good shape. Also, there are lots of quick movements you make in a game that you can't recreate outside of actual game play. These help build your overall basketball abilities, as well as your athleticism (explosiveness, jumping ability, etc.).- Workout with a jump ropeIt's an old school exercise, but it works. Jumping rope is a great way to build stamina, and work on your leg strength. In addition, it builds jumping ability (explosiveness, calf strength, etc.). It's really a great exercise.- Run stadium stairsAnother old school exericse and a great one. Running stadium stairs can really help your vertical leap because it build stamina, leg strength, and when done right, explosiveness. To work on explosiveness, use bounding movements. In otherwords, don't just get from one step the the next, but really leap and bound up from one step to the next.- Wall sits and squatsStrength training (like wall sits and squats) will help you build leg strength, which is a key component of athletic fitness, and therefore jumping ability. Remember to only use a weight that is comfortable for you, and to always have a trainer or training partner work out with you. You don't want to get hurt lifting too much weight, or lifting it improperly.- Explosive leapsThis is a great type of exercises. Do these at a park, or on a football field so that you are cushioned by the soft grass surface.One-legged jumps are done like this: leap as high as possible off of one foot, then come down and immediately leap as high as possible off the other leg. Repeat this for 10 to 15 jumps.Two-legged leaps are done like this: squat down so you are in the triple threat position. Now explode up and off the ground as if you are reaching for a rebound. Come down, gather yourself for a second or two, then leap up again, as high as possible. Do this 8 to 10 times.Remember, vertical leap is part leg strength and part explosiveness. In fact, the explosiveness part is the more important of the two. It's not about the size of your leg muscles, or how much weight you can put up in the gym. It's about your athletic ability, coordination, and your ability to explode up and off the ground.

Emacs Prelude

2012-06-24T19:41:27Z

Bozhidar: Reverted edits by 188.143.232.12 (talk) to last revision by Bozhidar

#REDIRECT [[Prelude]]

Guru-mode

2012-06-24T19:41:21Z

Bozhidar: Reverted edits by 37.59.80.67 (talk) to last revision by Bozhidar

{{Package
|name=guru-mode
|description=helps you to use Emacs effectively
|author=[[User:Bozhidar | Bozhidar Batsov]]
|maintainer=[[User:Bozhidar | Bozhidar Batsov]]
|source=https://github.com/bbatsov/guru-mode
}}

'''guru-mode''' disables some common keybindings and suggests the use of the established Emacs alternatives instead.

== Basic setup ==

<source lang="lisp">
(add-to-list 'load-path "/path/to/guru-mode/directory")
(require 'guru-mode)
(guru-mode +1) ;; to enable in all buffers
</source>

== Helpful keybindings ==

== Common Customization ==

== See Also ==

* [[Prelude]]

== Project Pages ==
* [https://github.com/bbatsov/guru-mode GitHub Repo]

== Tutorial Pages ==

[[Category:Convenience]][[Category:Third Party Package]]

Binary files

2012-06-24T19:41:16Z

Bozhidar: Reverted edits by 37.59.80.67 (talk) to last revision by 115.242.172.67

== Hexl Mode ==

There is a special major mode for editing binary files: Hexl mode. To use it, use M-x hexl-find-file instead of C-x C-f to visit the file. This command converts the file's contents to hexadecimal and lets you edit the translation. When you save the file, it is converted automatically back to binary.

You can also use M-x hexl-mode to translate an existing buffer into hex. This is useful if you visit a file normally and then discover it is a binary file.

Ordinary text characters overwrite in Hexl mode. This is to reduce the risk of accidentally spoiling the alignment of data in the file. There are special commands for insertion. Here is a list of the commands of Hexl mode:

*C-M-d
Insert a byte with a code typed in decimal.
*C-M-o
Insert a byte with a code typed in octal.
*C-M-x
Insert a byte with a code typed in hex.
*C-x [
Move to the beginning of a 1k-byte “page.”
*C-x ]
Move to the end of a 1k-byte “page.”
*M-g
Move to an address specified in hex.
*M-j
Move to an address specified in decimal.
*C-c C-c
Leave Hexl mode, going back to the major mode this buffer had before you invoked hexl-mode.
Other Hexl commands let you insert strings (sequences) of binary bytes, move by shorts or ints, etc.; type C-h a hexl-<RET> for details.

[[Category:Binary]]

Richard Stallman

2012-06-24T19:41:09Z

Bozhidar: Reverted edits by 37.59.80.67 (talk) to last revision by Kindahero

Richard Matthew Stallman, known as RMS, is the founder of
[[Free Software Foundation]], launcher of [[GNU Project]], writer of
[[GPL]], and creator of [[GNU Emacs]].

* Known as St.IGNUcius to the follower of [[Church of Emacs]].

== External links ==
* [http://www.stallman.org/ Stallman's personal blog]
* [http://www.fsf.org/blogs/rms/ Stallman's FSF blog]

[[Category: Emacs People]]
[[Category: Emacs Maintainer]]
[[Category: GNU]]

Quick Tutorial

2012-06-24T19:40:57Z

Bozhidar: Reverted edits by 37.59.80.67 (talk) to last revision by 129.93.11.90

Many thanks for being my own intorucstr on this theme. My spouse and i enjoyed your current article a lot and most of all preferred how you really handled the aspect I regarded as being controversial. You're always incredibly kind to readers much like me and assist me to in my lifestyle .

BibTeX

2012-06-24T19:40:50Z

Bozhidar: Reverted edits by 37.59.80.67 (talk) to last revision by 115.184.53.222

[[Category:Markup languages]][[Category:Document authoring]]