arch-tag lines in tutorials.

arch-tag lines in tutorials.

[Lute Kamstra]

What about deleting the arch-tag line when showing a tutorial?

Lute.


Index: lisp/help-fns.el
===================================================================
RCS file: /cvsroot/emacs/emacs/lisp/help-fns.el,v
retrieving revision 1.66
diff -c -r1.66 help-fns.el
*** lisp/help-fns.el	30 Mar 2005 22:50:17 -0000	1.66
--- lisp/help-fns.el	11 Apr 2005 11:58:03 -0000
***************
*** 1,7 ****
  ;;; help-fns.el --- Complex help functions
  
! ;; Copyright (C) 1985, 86, 93, 94, 98, 1999, 2000, 01, 02, 03, 2004
! ;;   Free Software Foundation, Inc.
  
  ;; Maintainer: FSF
  ;; Keywords: help, internal
--- 1,7 ----
  ;;; help-fns.el --- Complex help functions
  
! ;; Copyright (C) 1985, 1986, 1993, 1994, 1998, 1999, 2000, 2001, 2002,
! ;;   2003, 2004, 2005 Free Software Foundation, Inc.
  
  ;; Maintainer: FSF
  ;; Keywords: help, internal
***************
*** 64,69 ****
--- 64,74 ----
        (setq buffer-auto-save-file-name nil)
        (insert-file-contents (expand-file-name filename data-directory))
        (hack-local-variables)
+       (goto-char (point-max))
+       ;; Delete arch-tag line.
+       (when (search-backward "\n;;; arch-tag: " 
+ 			     (max (- (point-max) 3000) (point-min)) t)
+ 	(delete-region (point) (line-end-position 2)))
        (goto-char (point-min))
        (search-forward "\n<<")
        (beginning-of-line)

Re: arch-tag lines in tutorials.

[Marcelo Toledo]

For a newbie user the arch tag and the local variables will be something
that he doesn't know about. I don't think that only this will fix the
problem of having not know things in the buffer. If we're going to think
about it I think we need to think about a convention and a global
solution.

Lute Kamstra <Lute.Kamstra.lists@xs4all.nl> writes:

> What about deleting the arch-tag line when showing a tutorial?
>
> Lute.

-- 
Marcelo Toledo
marcelo@marcelotoledo.org
http://www.marcelotoledo.org
Mobile: 55 71 9116-1101

Re: arch-tag lines in tutorials.

[Miles Bader]

On 4/15/05, Marcelo Toledo <marcelo@marcelotoledo.org> wrote:
> For a newbie user the arch tag and the local variables will be something
> that he doesn't know about. I don't think that only this will fix the
> problem of having not know things in the buffer. If we're going to think
> about it I think we need to think about a convention and a global
> solution.

Is having things a newbie "doesn't know about" in the file actually
harmful (especially considering, it's more or less just a text file,
and this funny stuff is at the end)?

Maybe it's actually _good_, in that it might might peak their
curiousity, and make them aware (if often only peripherally) of a
feature they might not have thought about otherwise.

-Miles
-- 
Do not taunt Happy Fun Ball.

Re: arch-tag lines in tutorials.

[Lute Kamstra]

Miles Bader <snogglethorpe@gmail.com> writes:

> On 4/15/05, Marcelo Toledo <marcelo@marcelotoledo.org> wrote:
>> For a newbie user the arch tag and the local variables will be something
>> that he doesn't know about. I don't think that only this will fix the
>> problem of having not know things in the buffer. If we're going to think
>> about it I think we need to think about a convention and a global
>> solution.
>
> Is having things a newbie "doesn't know about" in the file actually
> harmful (especially considering, it's more or less just a text file,
> and this funny stuff is at the end)?
>
> Maybe it's actually _good_, in that it might might peak their
> curiousity, and make them aware (if often only peripherally) of a
> feature they might not have thought about otherwise.

I agree with you when it comes to local variables.  They must seem
strange to a new user.  But someone reading the tutorial wants to
learn about Emacs, so exposure to local variables is a good thing.

Arch-tag lines seem a bit too far off-topic to me, though.  (But I
don't think they are very harmful.)

Lute.

Re: arch-tag lines in tutorials.

[Miles Bader]

On 4/15/05, Lute Kamstra <Lute.Kamstra.lists@xs4all.nl> wrote:
> But someone reading the tutorial wants to
> learn about Emacs, so exposure to local variables is a good thing.
> 
> Arch-tag lines seem a bit too far off-topic to me, though.  (But I
> don't think they are very harmful.)

Yup, my thoughts exactly.

The only reason I can think of to remove such things is for aesthetics.

-Miles
-- 
Do not taunt Happy Fun Ball.

Re: arch-tag lines in tutorials.

[Richard Stallman]

    Is having things a newbie "doesn't know about" in the file actually
    harmful (especially considering, it's more or less just a text file,
    and this funny stuff is at the end)?

I don't think it is very harmful.  It's not a big issue.

    Maybe it's actually _good_, in that it might might peak their curiosity

Pique, not peak.