From 64a40e5d0a806a48fd3589470ea13e3889dc358e Mon Sep 17 00:00:00 2001 From: JenChieh Date: Sat, 30 Mar 2024 21:46:33 -0700 Subject: [PATCH] Update doc --- README.md | 90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) diff --git a/README.md b/README.md index fe1ff96..91affa2 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,92 @@ +[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) +[![JCS-ELPA](https://raw.githubusercontent.com/jcs-emacs/badges/master/elpa/v/sideline-load-cost.svg)](https://jcs-emacs.github.io/jcs-elpa/#/sideline-load-cost) + # sideline-load-cost > Display load/require module size with sideline + +[![CI](https://github.com/emacs-sideline/sideline-load-cost/actions/workflows/test.yml/badge.svg)](https://github.com/emacs-sideline/sideline-load-cost/actions/workflows/test.yml) + +## ๐Ÿ”จ Quickstart + +```elisp +(use-package sideline-load-cost + :init + (setq sideline-backends-right '(sideline-load-cost))) +``` + +## ๐Ÿ”ง Customization + +#### ๐Ÿงช Variables + +- `sideline-load-cost` - Face for load cost in sideline. + +## ๐Ÿ› ๏ธ Contribute + +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com) +[![Elisp styleguide](https://img.shields.io/badge/elisp-style%20guide-purple)](https://github.com/bbatsov/emacs-lisp-style-guide) +[![Donate on paypal](https://img.shields.io/badge/paypal-donate-1?logo=paypal&color=blue)](https://www.paypal.me/jcs090218) +[![Become a patron](https://img.shields.io/badge/patreon-become%20a%20patron-orange.svg?logo=patreon)](https://www.patreon.com/jcs090218) + +If you would like to contribute to this project, you may either +clone and make pull requests to this repository. Or you can +clone the project and establish your own branch of this tool. +Any methods are welcome! + +### ๐Ÿ”ฌ Development + +To run the test locally, you will need the following tools: + +- [Eask](https://emacs-eask.github.io/) +- [Make](https://www.gnu.org/software/make/) (optional) + +Install all dependencies and development dependencies: + +```sh +$ eask install-deps --dev +``` + +To test the package's installation: + +```sh +$ eask package +$ eask install +``` + +To test compilation: + +```sh +$ eask compile +``` + +**๐Ÿชง The following steps are optional, but we recommend you follow these lint results!** + +The built-in `checkdoc` linter: + +```sh +$ eask lint checkdoc +``` + +The standard `package` linter: + +```sh +$ eask lint package +``` + +*๐Ÿ“ P.S. For more information, find the Eask manual at https://emacs-eask.github.io/.* + +## โšœ๏ธ License + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . + +See [`LICENSE`](./LICENSE.txt) for details.