I wrote a mini manual for Emacs

I wrote a mini manual for Emacs

[Tu Do]

 Hi everyone,

I wrote an Emacs Mini Manual for complete beginners to be productive with
Emacs common tools without having to look all over the manual. It provides
a starting point before reading the full Emacs manual. Folow this link: Why
This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
fully.

I hope it will be useful for new people switching to Ubuntu and want to
have a nice development environment. If you find mistakes, please report it
to me. If you think I'm missing commonly used tools or some idiomatic uses
of Emacs, please tell me.

Thanks

Re: I wrote a mini manual for Emacs

[Tim Visher]

On Mon, Jun 16, 2014 at 1:24 AM, Tu Do <tuhdo1710@gmail.com> wrote:
> I wrote an Emacs Mini Manual for complete beginners to be productive with
> Emacs common tools without having to look all over the manual. It provides
> a starting point before reading the full Emacs manual. Folow this link: Why
> This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> fully.
>
> I hope it will be useful for new people switching to Ubuntu and want to
> have a nice development environment. If you find mistakes, please report it
> to me. If you think I'm missing commonly used tools or some idiomatic uses
> of Emacs, please tell me.

That's quite an effort. Are you aware of the tutorial? `M-x help-with-tutorial`

Re: I wrote a mini manual for Emacs

[Tu Do]

I do know. That's where I start learning Emacs. However, the tutorial does
not cover many other important things in Emacs. Read the section "Why this
guide?" in my tutorial for more details.


On Mon, Jun 16, 2014 at 8:34 PM, Tim Visher <tim.visher@gmail.com> wrote:

> On Mon, Jun 16, 2014 at 1:24 AM, Tu Do <tuhdo1710@gmail.com> wrote:
> > I wrote an Emacs Mini Manual for complete beginners to be productive with
> > Emacs common tools without having to look all over the manual. It
> provides
> > a starting point before reading the full Emacs manual. Folow this link:
> Why
> > This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> > fully.
> >
> > I hope it will be useful for new people switching to Ubuntu and want to
> > have a nice development environment. If you find mistakes, please report
> it
> > to me. If you think I'm missing commonly used tools or some idiomatic
> uses
> > of Emacs, please tell me.
>
> That's quite an effort. Are you aware of the tutorial? `M-x
> help-with-tutorial`
>

Re: I wrote a mini manual for Emacs

[Rusi]

On Monday, June 16, 2014 7:04:10 PM UTC+5:30, Tim Visher wrote:
> On Mon, Jun 16, 2014 at 1:24 AM, Tu Do  wrote:
> > I wrote an Emacs Mini Manual for complete beginners to be productive with
> > Emacs common tools without having to look all over the manual. It provides
> > a starting point before reading the full Emacs manual. Folow this link: Why
> > This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> > fully.
> > I hope it will be useful for new people switching to Ubuntu and want to
> > have a nice development environment. If you find mistakes, please report it
> > to me. If you think I'm missing commonly used tools or some idiomatic uses
> > of Emacs, please tell me.

> That's quite an effort. Are you aware of the tutorial? `M-x help-with-tutorial`

+10

Good work -- thanks for the efforts!

How do you make the animated gifs?

Re: I wrote a mini manual for Emacs

[Tim Visher]

On Mon, Jun 16, 2014 at 10:26 AM, Rusi <rustompmody@gmail.com> wrote:
> On Monday, June 16, 2014 7:04:10 PM UTC+5:30, Tim Visher wrote:
>> On Mon, Jun 16, 2014 at 1:24 AM, Tu Do  wrote:
>> > I wrote an Emacs Mini Manual for complete beginners to be productive with
>> > Emacs common tools without having to look all over the manual. It provides
>> > a starting point before reading the full Emacs manual. Folow this link: Why
>> > This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
>> > fully.
>> > I hope it will be useful for new people switching to Ubuntu and want to
>> > have a nice development environment. If you find mistakes, please report it
>> > to me. If you think I'm missing commonly used tools or some idiomatic uses
>> > of Emacs, please tell me.
>
>> That's quite an effort. Are you aware of the tutorial? `M-x help-with-tutorial`
>
> +10
>
> Good work -- thanks for the efforts!
>
> How do you make the animated gifs?

LICEcap is one tool that does it.

Re: I wrote a mini manual for Emacs

[tuhdo1710]

On Monday, June 16, 2014 9:26:41 PM UTC+7, Rusi wrote:
> On Monday, June 16, 2014 7:04:10 PM UTC+5:30, Tim Visher wrote:
> 
> > On Mon, Jun 16, 2014 at 1:24 AM, Tu Do  wrote:
> 
> > > I wrote an Emacs Mini Manual for complete beginners to be productive with
> 
> > > Emacs common tools without having to look all over the manual. It provides
> 
> > > a starting point before reading the full Emacs manual. Folow this link: Why
> 
> > > This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> 
> > > fully.
> 
> > > I hope it will be useful for new people switching to Ubuntu and want to
> 
> > > have a nice development environment. If you find mistakes, please report it
> 
> > > to me. If you think I'm missing commonly used tools or some idiomatic uses
> 
> > > of Emacs, please tell me.
> 
> 
> 
> > That's quite an effort. Are you aware of the tutorial? `M-x help-with-tutorial`
> 
> 
> 
> +10
> 
> 
> 
> Good work -- thanks for the efforts!
> 
> 
> 
> How do you make the animated gifs?

Thanks. Glad you like it.

I made the GIFs using byzanz-record: http://askubuntu.com/a/123515/13847

Re: I wrote a mini manual for Emacs

[Bastien]

Tu Do <tuhdo1710@gmail.com> writes:

> I wrote an Emacs Mini Manual for complete beginners to be productive with
> Emacs common tools without having to look all over the manual. It provides
> a starting point before reading the full Emacs manual. Folow this link: Why
> This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> fully.

This looks nice -- the Org-mode unicorn in the bottom right corner is
a bit confusing though, can you remove it?  (Otherwise, no problem of
course to reuse Worg's CSS.)

Thanks for writing this,

-- 
 Bastien

Re: I wrote a mini manual for Emacs

[tuhdo1710]

On Monday, June 16, 2014 10:14:25 PM UTC+7, Bastien wrote:
> Tu Do <tuhdo1710@gmail.com> writes:
> 
> 
> 
> > I wrote an Emacs Mini Manual for complete beginners to be productive with
> 
> > Emacs common tools without having to look all over the manual. It provides
> 
> > a starting point before reading the full Emacs manual. Folow this link: Why
> 
> > This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> 
> > fully.
> 
> 
> 
> This looks nice -- the Org-mode unicorn in the bottom right corner is
> 
> a bit confusing though, can you remove it?  (Otherwise, no problem of
> 
> course to reuse Worg's CSS.)
> 
> 
> 
> Thanks for writing this,
> 
> 
> 
> -- 
> 
>  Bastien

Sure, I will try to find a way to remove it. 

Re: I wrote a mini manual for Emacs

[Bastien]

tuhdo1710@gmail.com writes:

> Sure, I will try to find a way to remove it.

You need to remove this line

  background-image: url(http://orgmode.org/img/org-mode-unicorn-logo-worg.png);

from this file

  http://tuhdo.github.io/static/worg.css

Hope this helps,
  
-- 
 Bastien

Re: I wrote a mini manual for Emacs

[Tu Do]

Thanks Bastien,

I thought it was made from CSS, so I haven't looked at it until I have
time. The unicorn is removed now.

Thanks.

Re: I wrote a mini manual for Emacs

[Rusi]

On Tuesday, June 17, 2014 3:38:05 AM UTC+5:30, Bastien wrote:
> Tu Do writes:

> > Sure, I will try to find a way to remove it.

> You need to remove this line

>   background-image: url(http://orgmode.org/img/org-mode-unicorn-logo-worg.png);

> from this file

>   http://tuhdo.github.io/static/worg.css

> Hope this helps,

And of course it would be neat to put a note somewhere (at end maybe?)
saying that:

viz. that the nifty auto appear/hide contents etc comes from org
mode's css.

Re: I wrote a mini manual for Emacs

[solidius4747]

Vào 12:55:47 UTC+7 Thứ ba, ngày 17 tháng sáu năm 2014, Rusi đã viết:
> On Tuesday, June 17, 2014 3:38:05 AM UTC+5:30, Bastien wrote:
> 
> > Tu Do writes:
> 
> 
> 
> > > Sure, I will try to find a way to remove it.
> 
> 
> 
> > You need to remove this line
> 
> 
> 
> >   background-image: url(http://orgmode.org/img/org-mode-unicorn-logo-worg.png);
> 
> 
> 
> > from this file
> 
> 
> 
> >   http://tuhdo.github.io/static/worg.css
> 
> 
> 
> > Hope this helps,
> 
> 
> 
> And of course it would be neat to put a note somewhere (at end maybe?)
> 
> saying that:
> 
> 
> 
> viz. that the nifty auto appear/hide contents etc comes from org
> 
> mode's css.

I did put in Conclusion part. Or maybe you meant at the very bottom of the page? I remember there is a feature to append thing at the bottom when publish to HTML from Org files. I will find it out.

Re: I wrote a mini manual for Emacs

[solidius4747]

I add more content and move the section for browsing Linux kernel to the end of the guide. I think it will be clearer after people master basic concpets. I turned the demo (with the purpose of impressing people with Emacs) into a project, so people can put together the concepts they learned for practical things like large source code management. Probably it would be more useful if many "Projects" like this are added.

I will think more about this.

Re: I wrote a mini manual for Emacs

[MBR]

Good work!

I'd like to say something about the section ""I don't want a complicated 
'editor', I want something simple like Notepad(++)" in which you talk 
about IDEs.  When I started using Emacs (after about 10 years of using 
vi), I immediately noticed that Emacs was very different from any other 
editor I'd ever worked with.  With all other editors, I'd use them for 
editing text and do everything else from a shell prompt.

But once I started using Emacs I started telling people, "Emacs isn't an 
editor, it's a way of life!"  What I meant by that was that I found I 
was starting up a single instance of Emacs in the morning, and virtually 
everything I did the rest of the day was done inside Emacs.  If I needed 
to run a shell command, I'd do that inside an Emacs shell buffer because 
that way the command's output was automatically captured in the buffer 
and I could then use it like any other text - comparing it to other 
things with compare-window, searching for regular expressions in the 
output, saving some interesting portion of the output by simply copying 
it to a file, etc., etc.

Besides being able to run a shell inside the "editor", you could run 
your compiler and linker straight from Emacs and have it parse and 
highlight any errors; you could debug your code inside Emacs with gdb 
and later gud, and have many added benefits over running gdb directly 
from the shell.  One of those benefits is having it show you the source 
code, including a pointer showing what line of code you're about to execute.

The bottom line is that Emacs actually is an IDE, not merely a text 
editor.  It just happens to be an IDE that works on a dumb terminal. As 
a matter of fact, it's the original IDE! It existed before any of the 
GUI-style IDEs existed, and many features commonly found in IDEs were 
copied from Emacs.

So, it wouldn't hurt to emphasize at the beginning of your Mini Manual 
that Emacs should not be thought of as an editor.  It is a software 
development environment with powerful text editing capabilities.  And 
it's much more than even that!

    Mark Rosenthal

On 6/16/14 1:24 AM, Tu Do wrote:
>   Hi everyone,
>
> I wrote an Emacs Mini Manual for complete beginners to be productive with
> Emacs common tools without having to look all over the manual. It provides
> a starting point before reading the full Emacs manual. Folow this link: Why
> This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> fully.
>
> I hope it will be useful for new people switching to Ubuntu and want to
> have a nice development environment. If you find mistakes, please report it
> to me. If you think I'm missing commonly used tools or some idiomatic uses
> of Emacs, please tell me.
>
> Thanks
>

Re: I wrote a mini manual for Emacs

[Tu Do]

Well, I did in the section "Why Emacs?" at the beginning, emphasized that
Emacs is not a mere editor but a programming platform and has relation to
Lisp Machine. However, someone said that is not good for beginners to put
non-starter stuffs there. So I moved it to the appendix.


On Tue, Jun 17, 2014 at 1:11 AM, MBR <mbr@arlsoft.com> wrote:

>  Good work!
>
> I'd like to say something about the section ""I don't want a complicated
> 'editor', I want something simple like Notepad(++)" in which you talk about
> IDEs.  When I started using Emacs (after about 10 years of using vi), I
> immediately noticed that Emacs was very different from any other editor I'd
> ever worked with.  With all other editors, I'd use them for editing text
> and do everything else from a shell prompt.
>
> But once I started using Emacs I started telling people, "Emacs isn't an
> editor, it's a way of life!"  What I meant by that was that I found I was
> starting up a single instance of Emacs in the morning, and virtually
> everything I did the rest of the day was done inside Emacs.  If I needed to
> run a shell command, I'd do that inside an Emacs shell buffer because that
> way the command's output was automatically captured in the buffer and I
> could then use it like any other text - comparing it to other things with
> compare-window, searching for regular expressions in the output, saving
> some interesting portion of the output by simply copying it to a file,
> etc., etc.
>
> Besides being able to run a shell inside the "editor", you could run your
> compiler and linker straight from Emacs and have it parse and highlight any
> errors; you could debug your code inside Emacs with gdb and later gud, and
> have many added benefits over running gdb directly from the shell.  One of
> those benefits is having it show you the source code, including a pointer
> showing what line of code you're about to execute.
>
> The bottom line is that Emacs actually is an IDE, not merely a text
> editor.  It just happens to be an IDE that works on a dumb terminal.  As
> a matter of fact, it's the original IDE!  It existed before any of the
> GUI-style IDEs existed, and many features commonly found in IDEs were
> copied from Emacs.
>
> So, it wouldn't hurt to emphasize at the beginning of your Mini Manual
> that Emacs should not be thought of as an editor.  It is a software
> development environment with powerful text editing capabilities.  And it's
> much more than even that!
>
> Mark Rosenthal
>
> On 6/16/14 1:24 AM, Tu Do wrote:
>
>  Hi everyone,
>
> I wrote an Emacs Mini Manual for complete beginners to be productive with
> Emacs common tools without having to look all over the manual. It provides
> a starting point before reading the full Emacs manual. Folow this link: Why
> This Guide? <http://tuhdo.github.io/emacs-tutor.html#sec-2> <http://tuhdo.github.io/emacs-tutor.html#sec-2> to read it
> fully.
>
> I hope it will be useful for new people switching to Ubuntu and want to
> have a nice development environment. If you find mistakes, please report it
> to me. If you think I'm missing commonly used tools or some idiomatic uses
> of Emacs, please tell me.
>
> Thanks
>
>
>
>

Re: I wrote a mini manual for Emacs

[Rusi]

On Tuesday, June 17, 2014 8:07:12 AM UTC+5:30, Tu Do wrote:
> On Tue, Jun 17, 2014 at 1:11 AM, MBR wrote:

> >  Good work!
> > I'd like to say something about the section ""I don't want a complicated
> > 'editor', I want something simple like Notepad(++)" in which you talk about
> > IDEs.  When I started using Emacs (after about 10 years of using vi), I
> > immediately noticed that Emacs was very different from any other editor I'd
> > ever worked with.  With all other editors, I'd use them for editing text
> > and do everything else from a shell prompt.

> Well, I did in the section "Why Emacs?" at the beginning, emphasized that
> Emacs is not a mere editor but a programming platform and has relation to
> Lisp Machine. However, someone said that is not good for beginners to put
> non-starter stuffs there. So I moved it to the appendix.

I think thats a good choice.  In my 20+ years of using emacs and
convincing others (mostly unsuccessfully) to use it Ive found that
showing emacs' power is usually a put-off more than an attraction.

People say: «Look I ONLY want to do "..."! Why all this "..." »

रुसि [Just to make GG behave itself!]

Re: I wrote a mini manual for Emacs

[Yuri Khan]

On Tue, Jun 17, 2014 at 1:11 AM, MBR <mbr@arlsoft.com> wrote:

> So, it wouldn't hurt to emphasize at the beginning of your Mini Manual that
> Emacs should not be thought of as an editor.  It is a software development
> environment with powerful text editing capabilities.

It’s more than that — it’s a software development environment
development environment, and sometimes even a software (development
environment)^3 :)

Re: I wrote a mini manual for Emacs

[Barry Margolin]

In article <mailman.3768.1402942300.1147.help-gnu-emacs@gnu.org>,
 MBR <mbr@arlsoft.com> wrote:

> So, it wouldn't hurt to emphasize at the beginning of your Mini Manual 
> that Emacs should not be thought of as an editor.  It is a software 
> development environment with powerful text editing capabilities.  And 
> it's much more than even that!

There's a section at the end that discusses this. It's not clear that it 
needs to be emphasized at the beginning, before motivating it with an 
explanation of how to use Emacs in the first place.

-- 
Barry Margolin, barmar@alum.mit.edu
Arlington, MA
*** PLEASE post questions in newsgroups, not directly to me ***