[Solved] a manpage editor?

lspci · 2013-03-13 03:54:54

Does anybody know of a manpage/manpage-capable editor that actually works? I googled it and I saw a post on some ubuntu forum that seemed to mention that openoffice could be used to work with manpages; does anybody know if this is true or not? I also searched our own forum and wiki, but didn't find anything pertinent. I already searched the AUR and official/unofficial repos. I really am tired of creating manpages using manedit--it crashes randomly--so suggestions are eagerly welcomed.

Thanks.

Last edited by lspci (2013-03-13 06:38:53)

progandy · 2013-03-13 04:32:14

Maybe you want to write your manpages in a markdown dialect and convert that lateron?
http://rtomayko.github.com/ronn/

Edit: Or latex: ftp://ftp.tex.ac.uk/tex-archive/support … x2man.html

Last edited by progandy (2013-03-13 04:34:40)

lspci · 2013-03-13 04:38:02

progandy wrote:

Maybe you want to write your manpages in a markdown dialect and convert that lateron?
http://rtomayko.github.com/ronn/
Edit: Or latex: ftp://ftp.tex.ac.uk/tex-archive/support … x2man.html

Good point; that--so far--seems to explain a host of things that I have always wondered regarding manpages.

Last edited by lspci (2013-03-13 04:38:39)

progandy · 2013-03-13 04:55:20

Other tools to generate manpages from readble text are:
DocBookXslStylesheets
c2man
help2man
pod::man (perl)
docutils / rst2man (for reStructuredText)

jasonwryan · 2013-03-13 05:46:31

I've just used vim for the four or five I have written or patched; is that wrong?

lspci · 2013-03-13 06:31:14

jasonwryan wrote:

I've just used vim for the four or five I have written or patched; is that wrong?

No, 'cause I just used it to write a manpage for a package I just submitted to the AUR

EDIT: Let me revise that statement. There's nothing wrong with using vim, since manpages are written in a markup language and I've used vim to write html code tons of times, and html--of course--is another markup language.

Here are some websites that explain how to go about actually making manpages from scratch using plain old text editors. (for those, who like me, that may not have known how)
How to write a manpage

Writing Manual Pages

Manual Pages: Howto

Writing Effective Manpages

Creating Your Own MAN Page Version 1.0

Guide to writing mdoc UNIX manual pages

SOLVED: As has already been alluded to, I just used vim.

Last edited by lspci (2013-05-03 21:00:38)

keithhedger · 2013-08-29 19:54:58

Just came across this post I have recently uploaded this:

http://gtk-apps.org/content/show.php/Ma … ent=160219

Give it whirl you might like it

Thaodan · 2013-08-30 04:34:34

Org-Mode with man export works also very nice

kaari · 2013-08-31 15:26:21

txt2tags

Mr.Elendig · 2013-08-31 16:04:37

http://sphinx-doc.org/

Best thing since strict typing.

lspci · 2013-08-31 16:37:37

Thaodan wrote:

Org-Mode with man export works also very nice

Org-Mode is Emacs-only as far as I can tell, and I don't usually use Emacs. I have nothing against Emacs, even though I'm all about Vim, so I'll take a look at it and if it proves useful then I'll probably use it all the time, but it's probably gonna be a bit awkward since I always find myself trying to use different Vim keystrokes when I use other text editors.

Last edited by lspci (2013-08-31 16:42:24)

Mr. Shannon · 2013-08-31 16:48:42

lspci wrote:

Thaodan wrote:
Org-Mode with man export works also very nice
Org-Mode is Emacs-only as far as I can tell, and I don't usually use Emacs. I have nothing against Emacs, even though I'm all about Vim, so I'll take a look at it and if it proves useful then I'll probably use it all the time, but it's probably gonna be a bit awkward since I always find myself trying to use different Vim keystrokes when I use other text editors.

Actually org mode is for vim too. I have not used it so I can't say how good it is, but it does exist.
vim-orgmode

lspci · 2013-08-31 18:29:24

Mr. Shannon wrote:

lspci wrote:
Thaodan wrote:
Org-Mode with man export works also very nice
Org-Mode is Emacs-only as far as I can tell, and I don't usually use Emacs. I have nothing against Emacs, even though I'm all about Vim, so I'll take a look at it and if it proves useful then I'll probably use it all the time, but it's probably gonna be a bit awkward since I always find myself trying to use different Vim keystrokes when I use other text editors.
Actually org mode is for vim too. I have not used it so I can't say how good it is, but it does exist.
vim-orgmode

Oooh, nice. Definitely gotta check this puppy out, for sure.

Arch Linux

#1 2013-03-13 03:54:54

[Solved] a manpage editor?

#2 2013-03-13 04:32:14

Re: [Solved] a manpage editor?

#3 2013-03-13 04:38:02

Re: [Solved] a manpage editor?

#4 2013-03-13 04:55:20

Re: [Solved] a manpage editor?

#5 2013-03-13 05:46:31

Re: [Solved] a manpage editor?

#6 2013-03-13 06:31:14

Re: [Solved] a manpage editor?

#7 2013-08-29 19:54:58

Re: [Solved] a manpage editor?

#8 2013-08-30 04:34:34

Re: [Solved] a manpage editor?

#9 2013-08-31 15:26:21

Re: [Solved] a manpage editor?

#10 2013-08-31 16:04:37

Re: [Solved] a manpage editor?

#11 2013-08-31 16:37:37

Re: [Solved] a manpage editor?

#12 2013-08-31 16:48:42

Re: [Solved] a manpage editor?

#13 2013-08-31 18:29:24

Re: [Solved] a manpage editor?

Board footer