Berkeley CSUA MOTD:Entry 38958
Berkeley CSUA MOTD
 
WIKI | FAQ | Tech FAQ
http://csua.com/feed/
2017/10/23 [General] UID:1000 Activity:popular
10/23   

2005/8/3-4 [Computer/SW/Unix] UID:38958 Activity:low
8/2     I work at a company where we do all our engineering work on unix.
        But most of our documentation is done on MS Word. Each of us writes
        our own docs and someone combines everything in the end resulting
        in 600 pages of unreadable crap. I'm looking for a unix-based
        documentation tool that stores individual parts of a document
        in some sort of text format (like XML) and that lets multiple
        people collaborate on a single large document using revision
        control like CVS. Any suggestions?
        \_ DocBook is what you need
           \_ Thanks. This was the type of stuff I was looking for.
        \_ What's wrong with HTML?  -tom
        \_ latex!  i still haven't found a better alternative for this kind
           of collaborative work.  and try to reduce the amount of
           formatting people are allowed to do w/ some style conventions.
           i also put xfig figures in CVS and use makefiles to automate
           generation of EPS, PDF, etc. from these diff-friendly text
           formats.
           \_ Ok, I'm one of those people who thinks that "Anyone can
              learn C++" or "anyone can learn unix". I mean, you'd be
              a total moron if you can't, right? But you can't
              reasonably expect most people to. "Grandma, I got you
              a new computer. All you have to do is check up on security
              updates, download a new kernel source tree, recompile,
              and install. It's not that hard. Anyone can do it."
              I'm not going to ask an entire group to learn latex.
              \_ I've found that M$ Word's "ease of use" is largely
                 illusory.  It's not that much harder to look up
                 and use \tiny for a text size than screw with a bunch
                 of menus and buttons.  And if you do it once and work
                 from a template, it's actually easier than using Word...
                 \_ This is a common mistake--Word's _overall_ "ease of use"
                    is a fairy tale.  However, getting it to quickly do basic
                    shit without too much fidgeting is a lot easier for Joe
                    Schmo than LaTeX or other, more powerful tools.  The same
                    goes for StarOffice and many other "wysiwig" toys, the only
                    difference is that Joe Schmo will eventually get a doc
                    written in word which "looks different" in StarOffice.  As
                    for your \tiny example, yes, for us it's not much harder.
                    However, for most non-technical people, and yes, they do
                    exist, something visual like a button is way more intuitive
                    than a line of text.  The danger of this, though, is that
                    most people/companies will inevitably want to do more
                    complex shit, at which they have already worked themselves
                    into a hole with buttons and similar "easy" crap. -John
                 \_ While I agree that LaTex is not that hard, especially
                    if he was to set up a nice standard set of macros
                    and scripts for everyone to use, I can see why a
                    Wysiwyg editor would be preferable.
        \_ How are you currently having your Unix programmers do
           documentation in Word?  Also, While LaTex is not that hard,
           especially if you were to set up a nice standard set of macros
           and scripts for everyone to use, I can see why a Wysiwyg editor
           would be preferable.  Unfortunatly, I don't know of a good one
           for this task in ANY OS.
           documentation in Word?
        \_ I believe this is the sort of thing Adobe FrameMaker was
           made for. You may also want to look into TeXmacs. I think
           the HTML suggestion is a good one, though.
        \_ Pick any other word processor that runs on your flavor of unix.  Or
           use OpenOffice 2 (you must be using a different machine for Word,
           right?).  Since no one knows how to use Word anyway, there won't be
           a retraining cost.
        \_ Why not use a wiki?
           \_ Probably depends on the kinds of control and approval issues they
              have.  My current client is really really word-dependent because
              they have such incredible regulatory and audit needs that they
              had to have some format that'd let them exercise a lot of
              control over changes (note that I am in no way advocating ms-word
              as a good way to do this.)  -John
ERROR, url_link recursive (eces.Colorado.EDU/secure/mindterm2) 2017/10/23 [General] UID:1000 Activity:popular
10/23   

You may also be interested in these entries...
2012/8/29-11/7 [Computer/SW/Security] UID:54467 Activity:nil
8/29    There was once a CSUA web page which runs an SSH client for logging
        on to soda.  Does that page still exist?  Can someone remind me of the
        URL please?  Thx.
        \_ what do you mean? instruction on how to ssh into soda?
           \_ No I think he means the ssh applet, which, iirc, was an applet
              that implemented an ssh v1 client.  I think this page went away
	...
2012/8/30-11/7 [Computer/SW/Unix, Computer/SW/Apps] UID:54470 Activity:nil
8/30    Is wall just dead? The wallall command dies for me, muttering
        something about /var/wall/ttys not existing.
        \_ its seen a great drop in usage, though it seems mostly functional.
            -ERic
        \_ Couldn't open wall log!: Bad file descriptor
           Could not open wall subscription directory /var/wall/ttys: No such file or directory
	...
2012/3/29-6/4 [Computer/HW/Memory, Computer/HW/CPU, Computer/HW/Drives] UID:54351 Activity:nil
3/29    A friend wants a PC (no mac). She doesn't want Dell. Is there a
        good place that can custom build for you (SSD, large RAM, cheap video
        card--no game)?
        \_ As a side note: back in my Cal days more than two decades ago when
           having a 387SX made me the only person with floating-point hardware,
           most machines were custom built.
	...
2012/1/27-3/26 [Computer/SW/Unix] UID:54299 Activity:nil
1/27    Interesting list of useful unix tools. Shout out to
        cowsay even!
        http://www.stumbleupon.com/su/3428AB/kkovacs.eu/cool-but-obscure-unix-tools
        \_ This is nice.  Thanks.
	...
2011/11/20-2012/2/6 [Computer/SW/Unix, Computer/Companies/Apple] UID:54237 Activity:nil
11/20   Are there tools that can justify a chunk of plain ASCII text by
        replacing words with words of similar meaning and inserting/removing
        commas into the text?  I received a 40-line plain text mail where
        all the lines are justified on left and right.  Every word and comma
        is followed by only one space, and every period is followed by two
        spaces.  The guy is my kid's karate instructor which I don't think is
	...
2011/10/26-12/6 [Computer/SW/Unix] UID:54202 Activity:nil
10/24  What's an easy way to see if say column 3 of a file matches a list of
       expressions in a file? Basically I want to combine "grep -f <file>"
       to store the patterns and awk's $3 ~ /(AAA|BBB|CCC)/ ... I realize
       I can do this with "egrep -f " and use regexp instead of strings, but
       was wondering if there was some magic way to do this.
       \_ UNIX has no magic. Make a shell script to produce the ask or egrep
	...