dotfiles/awesome/lain
2023-01-20 16:22:46 +01:00
..
.github/workflows Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
icons Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
layout Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
util Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
widget Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
wiki Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
.gitmodules Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
.luacheckrc Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
helpers.lua Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
init.lua Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
ISSUE_TEMPLATE.md Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
lain-scm-1.rockspec Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
LICENSE Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00
README.rst Changed structure for dotfile installer 2023-01-20 16:22:46 +01:00

Lain
====

.. image:: https://github.com/lcpz/lain/actions/workflows/main.yml/badge.svg

-------------------------------------------------
Layouts, widgets and utilities for Awesome WM 4.x
-------------------------------------------------

:Author: Luca CPZ
:Version: git
:License: GNU-GPL2_
:Source: https://github.com/lcpz/lain

Description
-----------

Successor of awesome-vain_, this module provides alternative layouts, asynchronous widgets and utility functions for Awesome_.

Contributions
-------------

Constructive criticism and suggestions are welcome.

If you want to create a pull request, make sure that:

- Your code fits with the general style of the module. In particular, you should use the same indentation pattern that the code uses, and also avoid adding space at the ends of lines.

- Your code its easy to understand, maintainable, and modularized. You should also avoid code duplication wherever possible by adding functions to or using lain.helpers_. If something is unclear, or you can not write it in such a way that it will be clear, explain it with a comment.

- You test your changes before submitting to make sure that your code works and does not break other parts of the module.

- You update ``wiki`` submodule with a thorough section, if necessary.

Contributed widgets have to be put in ``widget/contrib``.

.. _GNU-GPL2: http://www.gnu.org/licenses/gpl-2.0.html
.. _awesome-vain: https://github.com/vain/awesome-vain
.. _Awesome: https://github.com/awesomeWM/awesome
.. _lain.helpers: https://github.com/lcpz/lain/blob/master/helpers.lua