librelist archives

« back to archive

Announcement: outline support

Announcement: outline support

From:
Paul Rankin
Date:
2014-11-19 @ 11:53
I've pushed Fountain Mode version 1.4.0 online with `outline.el`
integration. It should be available via MELPA soon. It treats section
headings 1--5 as outline subtree levels 1--5, with scene headings as
level 6, and introduces the commands:

- `C-c C-f outline-forward-same-level`
- `C-c C-n outline-next-visible-heading`
- `C-c C-p outline-previous-visible-heading`
- `C-c C-u outline-up-heading`
- `C-c C-v outline-move-subtree-down`
- `C-c C-^ outline-move-subtree-up`
- `C-c C-SPC outline-mark-subtree`

I've also introduced outline visibility cycling, similar to Org Mode,
which is something I've been wanting to include for a long time.

- `<tab> fountain-outline-cycle`
- `<backtab> fountain-outline-cycle-global`

This is the first time I'm intentionally leaving a gap between the MELPA
release and tagged MELPA-stable release, the idea being that it gives
everyone a chance to report any bugs before the release is pushed out
for those using MELPA-stable (which I continue to encourage). Going
forward I doubt there will be any x.x.0 tagged stable releases.

Unfortunately, `outline.el` seems to have a bug when attempting to move
the last outline subtree up, or the second-last subtree down. I've
reported it to the maintainers. As a workaround, you can just use
`fountain-outline-cycle-global` then `<C-S-backspace>` to kill the
section or scene, re-position the point, then yank (`C-y`) the text
back.

-- 
Paul W. Rankin
http://www.paulwrankin.com

Re: [emacs.fountain] Announcement: outline support

From:
Paul Rankin
Date:
2014-11-24 @ 07:52
Paul Rankin <paul@tilk.co> writes:

> Unfortunately, `outline.el` seems to have a bug when attempting to move
> the last outline subtree up, or the second-last subtree down. I've
> reported it to the maintainers. As a workaround, you can just use
> `fountain-outline-cycle-global` then `<C-S-backspace>` to kill the
> section or scene, re-position the point, then yank (`C-y`) the text
> back.

The `outline-mode` bug looks like it will be fixed in the near future:
http://debbugs.gnu.org/cgi/bugreport.cgi?bug=19102

However, it might be a while before the update is released, so, since I
wanted outlining to work properly without users needing to wait for the
Emacs update, I rewrote the offending function, and it is included in
the master branch of `fountain-mode` (which forms the latest MELPA
release, MELPA-stable lags behind by design).

-- 
Paul W. Rankin
http://www.paulwrankin.com