@@ -2,11 +2,42 @@

 An [Ansible][] [role][] for deploying custom [X][] session [`.desktop`][] file.

+Adds a `/etc/X11/sessions/Xsession.desktop` file that is picked up by [X

+display manager][]s and, if chosen, runs `/etc/X11/Xsession` (which probably

+runs your `$HOME/.xsession`).

+

 [`ansible-role-xsession`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xsession

 [Ansible]: https://docs.ansible.com/ansible

 [role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html

 [X]: https://en.wikipedia.org/wiki/X_Window_System

 [`.desktop`]: https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html#introduction

+[X display manager]: https://en.wikipedia.org/wiki/X_display_manager

+

+## Usage

+

+Example [`requirements.yml`][]:

+

+```yaml

+---

+

+roles:

+  - name: 'xsession'

+    src: 'https://git.rcrnstn.net/rcrnstn/ansible-role-xsession'

+    scm: 'git'

+```

+

+Example [playbook][]:

+

+```yaml

+---

+

+- hosts: 'all'

+  roles:

+    - role: 'xsession'

+```

+

+[`requirements.yml`]: https://docs.ansible.com/ansible/latest/galaxy/user_guide.html#installing-multiple-roles-from-a-file

+[playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html

 ## License

new file mode 100644

@@ -0,0 +1,4 @@

+[Desktop Entry]

+Name=Xsession

+Exec=/etc/X11/Xsession

+TryExec=/etc/X11/Xsession

new file mode 100644

@@ -0,0 +1,13 @@

+---

+

+- name: 'Copy xsession.desktop'

+  become: yes

+  copy:

+    # dest: '/usr/share/xsessions/xsession.desktop'

+    # dest: '/etc/X11/sessions/xsession.desktop'

+    dest: '/etc/X11/'

+    src: 'sessions'

+    owner: 'root'

+    group: 'root'

+    mode: '0644'

+    directory_mode: '0755'