{"id":28750557,"url":"https://github.com/agermanidis/.emacs.d","last_synced_at":"2026-02-16T17:34:02.300Z","repository":{"id":141073647,"uuid":"1355532","full_name":"agermanidis/.emacs.d","owner":"agermanidis","description":"GNU Emacs configuration files","archived":false,"fork":false,"pushed_at":"2011-03-25T22:34:08.000Z","size":560,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-03T23:53:12.489Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agermanidis.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-02-11T15:36:39.000Z","updated_at":"2014-02-05T00:55:17.000Z","dependencies_parsed_at":"2023-03-12T02:01:38.697Z","dependency_job_id":null,"html_url":"https://github.com/agermanidis/.emacs.d","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/agermanidis/.emacs.d","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agermanidis%2F.emacs.d","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agermanidis%2F.emacs.d/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agermanidis%2F.emacs.d/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agermanidis%2F.emacs.d/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agermanidis","download_url":"https://codeload.github.com/agermanidis/.emacs.d/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agermanidis%2F.emacs.d/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29513991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T09:05:14.864Z","status":"ssl_error","status_checked_at":"2026-02-16T08:55:59.364Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-16T21:39:41.200Z","updated_at":"2026-02-16T17:34:02.281Z","avatar_url":"https://github.com/agermanidis.png","language":"Emacs Lisp","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Emacs Starter Kit\n\nThe Starter Kit should provide a saner set of defaults than you get\nnormally with Emacs. It was originally intended for beginners, but it\nshould provide a reasonable working environment for anyone using Emacs\nfor dynamic languages. It also bundles a number of useful libraries\nthat are not distributed with Emacs for various reasons.\n\nThe latest version is at http://github.com/technomancy/emacs-starter-kit/\n\n## Learning\n\nThis won't teach you Emacs, but it'll make it easier to get\ncomfortable. To access the tutorial, press control-h followed by t.\n\nYou may also find the [PeepCode Meet Emacs\nscreencast](http://peepcode.com/products/meet-emacs) helpful. The\n[Emacs Wiki](http://emacswiki.org) is also very handy.\n\n## Installation\n\n1. Install GNU Emacs (at least version 22, 23 is preferred)\n   Use your package manager if you have one.\n   Otherwise Mac users may get [some prebuilt binaries](http://emacsformacosx.com/), and\n   Windows users can get them [from GNU](http://ftp.gnu.org/pub/gnu/emacs/windows/emacs-23.1-bin-i386.zip).\n2. Move the directory containing this file to ~/.emacs.d\n   (If you already have a directory at ~/.emacs.d move it out of the\n   way and put this there instead.)\n3. Launch Emacs!\n\nIf you find yourself missing some autoloads after an update (which\nshould manifest itself as \"void function: foobar\" errors) try M-x\nregen-autoloads. After some updates an M-x recompile-init will be\nnecessary; this should be noted in the commit messages.\n\nIf you want to keep your regular ~/.emacs.d in place and just launch a\nsingle instance using the starter kit, try the following invocation:\n\n  $ emacs -q -l ~/src/emacs-starter-kit/init.el\n\nNote that having a ~/.emacs file might override the starter kit\nloading, so if you've having trouble loading it, make sure that file\nis not present.\n\n## Structure\n\nThe init.el file is where everything begins. It's the first file to\nget loaded. The starter-kit-* files provide what I consider to be\nbetter defaults, both for different programming languages and for\nbuilt-in Emacs features like bindings or registers.\n\nFiles that are pending submission to ELPA are bundled with the starter\nkit under the directory elpa-to-submit/. The understanding is that\nthese are bundled just because nobody's gotten around to turning them\ninto packages, and the bundling of them is temporary. For these\nlibraries, autoloads will be generated and kept in the loaddefs.el\nfile. This allows them to be loaded on demand rather than at startup.\n\nThere are also a few files that are meant for code that doesn't belong\nin the Starter Kit. First, the user-specific-config file is the file\nnamed after your user with the extension \".el\". In addition, if a\ndirectory named after your user exists, it will be added to the\nload-path, and any elisp files in it will be loaded. Finally, the\nStarter Kit will look for a file named after the current hostname\nending in \".el\" which will allow host-specific configuration. This is\nwhere you should put code that you don't think would be useful to\neveryone. That will allow you to merge with newer versions of the\nstarter-kit without conflicts.\n\n## Emacs Lisp Package Archive\n\nLibraries from [ELPA](http://tromey.com/elpa) are preferred when\navailable since dependencies are handled automatically, and the burden\nto update them is removed from the user. In the long term, ideally\neverything would be installed via ELPA, and only package.el would need\nto be distributed with the starter kit. (Or better yet, package.el\nwould come with Emacs...) See starter-kit-elpa.el for a list of\nlibraries that are pending submission to ELPA. Packages get installed\nin the elpa/ directory.\n\nThere's no vendor/ directory in the starter kit because if an external\nlibrary is useful enough to be bundled with the starter kit, it should\nbe useful enough to submit to ELPA so that everyone can use it, not\njust users of the starter kit.\n\nSometimes packages are removed from the Starter Kit as they get added\nto ELPA itself. This has occasionally caused problems with certain\npackages. If you run into problems with such a package, try removing\neverything from inside the elpa/ directory and invoking M-x\nstarter-kit-elpa-install in a fresh instance.\n\n## Variants of Emacs\n\nThe Starter Kit is designed to work with GNU Emacs version 22 or\ngreater. Using it with forks or other variants is not supported. It\nprobably won't work with XEmacs, though some have reported getting it\nto work with Aquamacs. However, since Aquamacs is not portable,\nit's difficult to test in it, and breakage is common.\n\n## Contributing\n\nIf you know your way around Emacs, please try out the starter kit as a\nreplacement for your regular dotfiles for a while. If there's anything\nyou just can't live without, add it or let me know so I can add\nit. Take a look at what happens in init.el to get started.\n\nAlso: see the file TODO. Helping submit new libraries to ELPA is the\neasiest way to help out. There are two ways you can do this: either\ntake new libraries and make them ready for ELPA, dropping them in the\nelpa-to-submit directory or take files that are already in\nelpa-to-submit, ensuring all their dependencies are correctly loaded\ninto ELPA, and sending them to the ELPA maintainer. There are details\nat http://tromey.com/elpa/upload.html for how ELPA submission\nworks. Grep the project for TODO for other things.\n\nFiles are licensed under the same license as Emacs unless otherwise\nspecified. See the file COPYING for details.\n\nThe latest version is at http://github.com/technomancy/emacs-starter-kit/\n\nOn Unix, /home/$USER/.emacs.d, on windows Documents and Settings/%your\nuser name%/Application Data\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagermanidis%2F.emacs.d","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagermanidis%2F.emacs.d","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagermanidis%2F.emacs.d/lists"}