10:16 p.m.
2007/4/2, Jason Spiro <jasonspiro4(a)gmail.com> wrote:
By the way, an idea: Perhaps it would be better if the material was
hosted on a wiki ( perhaps at
http://commons.wikimedia.org/wiki/Category:Software_documentation )
and your page linked to the material on the wiki? Then it would be
easier for people to contribute. What do all of you think? Phil,
would you like me to upload the material to the site I mentioned?
Hi Phil,
Could you kindly mention a few times in the guided tour that C-h means
Control-h and M-x means Alt-x?
Or would you like me to make the changes? I can, though it'd be
easier for me to do so if the document was moved to a wiki as
mentioned above. :-)
--
Jason Spiro: computer consulting with a smile.
I provide software development and training services to clients worldwide.
Contact me for a FREE consultation. Satisfaction guaranteed.
+1 (416) 781-5938 / Email: info(a)jspiro.com / MSN: jasonspiro(a)hotmail.com
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
5:26 p.m.
Hi Jason,
On 4/2/07, Jason Spiro <jasonspiro4(a)gmail.com> wrote:
By the way, an idea: Perhaps it would be better if the material was
hosted on a wiki ( perhaps at
http://commons.wikimedia.org/wiki/Category:Software_documentation )
and your page linked to the material on the wiki? Then it would be
easier for people to contribute.
Will do. It looks like Wikimedia is certainly the place for the
slides. For a more easily editable format, I can wikify the HTML
version, too-- would Wikibooks be a better place for that? e.g.
<http://en.wikibooks.org/wiki/Wikibooks:Computer_software_bookshelf>
On 4/12/07, Jason A. Spiro <jasonspiro(a)gmail.com> wrote:
Could you kindly mention a few times in the guided tour that C-h
means
Control-h and M-x means Alt-x?
Will do.
--Phil
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
6:34 p.m.
On 4/13/07, Phil Sung <psung(a)mit.edu> wrote:
On 4/2/07, Jason Spiro <jasonspiro4(a)gmail.com> wrote:
> By the way, an idea: Perhaps it would be better if the material was
> hosted on a wiki ( perhaps at
> http://commons.wikimedia.org/wiki/Category:Software_documentation )
> and your page linked to the material on the wiki? Then it would be
> easier for people to contribute.
Will do. It looks like Wikimedia is certainly the place for the
slides. For a more easily editable format, I can wikify the HTML
version, too-- would Wikibooks be a better place for that?
I've posted the slides to Wikimedia commons:
http://commons.wikimedia.org/wiki/Image:Emacs-guided-tour-1.pdf
Cheers,
Phil
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
8:16 p.m.
2007/4/13, Phil Sung <psung(a)mit.edu>:
Hi Jason,
On 4/2/07, Jason Spiro <jasonspiro4(a)gmail.com> wrote:
> By the way, an idea: Perhaps it would be better if the material was
> hosted on a wiki ( perhaps at
> http://commons.wikimedia.org/wiki/Category:Software_documentation )
> and your page linked to the material on the wiki? Then it would be
> easier for people to contribute.
Will do.
Hi Phil,
Cool, it was kind of you to do that. Unfortunately they don't yet
accept OpenOffice 2.0 presentations so we can't upload the source,
making it harder to edit.[1] I guess if I make any edits I'll send
them back to you, and I'll vote for the relevant feature request.
It looks like Wikimedia is certainly the place for the
slides. For a more easily editable format, I can wikify the HTML
version, too-- would Wikibooks be a better place for that? e.g.
<http://en.wikibooks.org/wiki/Wikibooks:Computer_software_bookshelf>
Sounds like a good idea, but one small niggle: then anyone can edit.
Will the FSF need copyright assignment for small edits? For large
edits? How about the licensing issue: will the modified material be
only GFDL as opposed to tri-licensed? Do we delete all edits from
people who haven't put a message on their user page that they
tri-license all their edits to the document? Would it be a good idea
to put a message inside an HTML comment at the top of the document at
Wikibooks about licensing and/or copyright assignment? I plan to set
up a wiki (probably using the TWiki software) at my site
www.jspiro.com Real Soon Now :-) -- should I expedite that process?
Or does that not matter too much and is it a good idea to go ahead
despite these legal niggles? Better to go ahead and create than to
get stuck about legal issues.
Cheers,
Jason
[1] According to
http://commons.wikimedia.org/wiki/Commons_talk:File_types#Open_Office_2.0
they haven't yet enabled upload of that file type. Lower down on the
same page, Duesentrieb wrote "allowing additional formats doesn't just
mean flipping a switch. It needs a software developer to look at it,
as well as approval from server admins. Both can be requested on
bugzilla, but are generally only looked at seriously if there is
popular demand for it on a project. To document such demand, it would
probably be better to ask at [[COM:VP]], since this page here isn't
much watched by "normal users".
--
Jason Spiro: computer consulting with a smile.
I provide software development and training services to clients worldwide.
Contact me for a FREE consultation. Satisfaction guaranteed.
+1 (416) 781-5938 / Email: info(a)jspiro.com / MSN: jasonspiro(a)hotmail.com
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
6:37 p.m.
Jason Spiro writes:
Sounds like a good idea, but one small niggle: then anyone can edit.
Well, that's the whole idea, isn't it?
Will the FSF need copyright assignment for small edits? For large
edits?
For the edits as such, no, and no. However, without copyright
assignment changes will not be distributed with (GNU) Emacs for the
foreseeable future. XEmacs is not so fastidious.
How about the licensing issue: will the modified material be
only GFDL as opposed to tri-licensed?
That's up to Wikipedia and the authors of the modifications.
Do we delete all edits from people who haven't put a message on
their user page that they tri-license all their edits to the
document?
I think it's preferable for Phil to maintain a canonical version under
"all of the above", but that's up to him; the legal niggles can get
annoying. Also, trashing other people's edits simply because they're
not as generous in licensing as you are may be against Wikimedia
policy, and certainly is somewhat paradoxical.
Or does that not matter too much and is it a good idea to go ahead
despite these legal niggles? Better to go ahead and create than to
get stuck about legal issues.
The legal niggles necessarily matter to XEmacs, because of the complex
copyright situation we find ourselves in. Whether they matter to Phil
depends on how he feels about the possibility that some of his
downstream (like XEmacs and GNU Emacs) may not be able or willing to
incorporate such edits, or (in the case of users who choose the MIT
license) he himself may not be able to use edits in future versions if
they redistribute in "closed" form.
Personally, I think he should go ahead and publish. The main body
remains under the licenses he chose.
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
9:16 p.m.
On 4/14/07, Stephen J. Turnbull <stephen(a)xemacs.org> wrote:
I think it's preferable for Phil to maintain a canonical version
under
"all of the above"...
I agree. At least until I figure out whether (and how) GNU Emacs would
ship a wiki-modified version, I'd be willing to maintain an
ok-for-GNU-Emacs version.
On 4/13/07, Jason Spiro <jasonspiro4(a)gmail.com> wrote:
Will the FSF need copyright assignment for small edits? For large
edits? How about the licensing issue: will the modified material be
only GFDL as opposed to tri-licensed?
Presumably if we had a dedicated wiki for this, we could require that
contributions be tri-licensed (just as Wikipedia requires that
contributions be GFDL'd). But the FSF would still want copyright
assignments in either case if it were going to ship a wiki version, so
I think using Wikimedia is just fine now.
--Phil
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
11:41 a.m.
"Phil Sung" <psung(a)mit.edu> writes:
On 4/14/07, Stephen J. Turnbull <stephen(a)xemacs.org> wrote:
> I think it's preferable for Phil to maintain a canonical version under
> "all of the above"...
I agree. At least until I figure out whether (and how) GNU Emacs would
ship a wiki-modified version, I'd be willing to maintain an
ok-for-GNU-Emacs version.
It is not so much a matter of ok-for-GNU-Emacs as a matter of
ok-for-Phil-Sung. You have signed a contract with the FSF that makes
you liable for all damages arising from code you contribute to the FSF
without being its principal copyright holder.
So it is not just a matter of getting contributors to agree to
tri-licensing for you, it is a matter of getting them to assign
copyright to you or the FSF. Only in that case can you feed external
changes back to the version distributed by the FSF. You are, of
course, free to treat external contributions according to your
personal standards as long as you don't feed them to the FSF.
And of course you can choose to be less "fastidious" about this (as
Stephen chooses to call it) and hope that nobody will ever use his
contribution as a legal asset against the FSF.
--
David Kastrup
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
1:52 p.m.
New subject: Releasing the Emacs guided tour into the public domain; also, video
David Kastrup writes:
And of course you can choose to be less "fastidious" about
this (as
Stephen chooses to call it) and hope that nobody will ever use his
contribution as a legal asset against the FSF.
It's not a worry. The FSF won't accept a contribution from Phil on
behalf of somebody else, and Phil won't erase somebody else's
copyright notice.
The worst that's going to happen is that RMS is going to say "GNU
won't distribute this under a permissive license" (and possibly not
under the GPL). In fact, that's a near certainty, which is why I
asked for Phil's help for the main body.
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
1:59 p.m.
New subject: Releasing the Emacs guided tour into the public domain; also, video
"Stephen J. Turnbull" <stephen(a)xemacs.org> writes:
David Kastrup writes:
> And of course you can choose to be less "fastidious" about this
> (as Stephen chooses to call it) and hope that nobody will ever
> use his contribution as a legal asset against the FSF.
It's not a worry. The FSF won't accept a contribution from Phil on
behalf of somebody else,
They can only work with what they know.
and Phil won't erase somebody else's copyright notice.
Copyright does not depend on copyright notices, and quite a few
contributors don't tack on any of their own. That does not make them
lose their copyright. It is not like you would not know this.
The worst that's going to happen is that RMS is going to say
"GNU
won't distribute this under a permissive license" (and possibly not
under the GPL).
No. The worst that is going to happen (to Phil, not you) is that the
FSF distributes the stuff as part of Emacs, then later some company
creates a proprietary branch of Emacs, the FSF files for statutory
damages and stop of distribution and gets its case thrown out of court
because they have dirty hands, having distributed code written by an
employee of said company.
In that case, Phil can be held liable for the damages that would
otherwise have been awarded to the FSF. And he undersigned a contract
specifying exactly that.
Copyrights are a quagmire (which is not the FSF's fault), and you do
nobody a favor by papering over it.
--
David Kastrup
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
10:22 a.m.
Phil Sung writes:
Presumably if we had a dedicated wiki for this, we could require
that
contributions be tri-licensed (just as Wikipedia requires that
contributions be GFDL'd). But the FSF would still want copyright
assignments in either case if it were going to ship a wiki version, so
I think using Wikimedia is just fine now.
[Note: Since Phil posted this, he has indicated in private mail that
he wishes to restrict redistribution to the GPL and GFDL terms.]
I have created an XEmacs package, but was unable to "cvs add" the
directory, not having sufficient permission. Norbert, do you know
what's going on here? Can you help with this or tell me how to do it?
A packagized tarball is available at
http://turnbull.sk.tsukuba.ac.jp/Tools/XEmacs/guided-tour/
The sources (for Norbert if he needs it, others probably want to wait
for CVS), package-index, and Windows setup-packages.ini are also
available there.
Phil, I attach the ChangeLog and the infrastructure Lisp for making
the Guided Tour available in the Help menu. Please check the
following points:
1. Use of your name. Tastes differ, and you may want more or less
credits. I wish to respect your tastes. :-)
2. Check the comments about permissions in the ChangeLog. If you
have qualms about it, let me know.
3. Check the permissions notice in the function `guided-tour-about'
in the Lisp. (It's the last thing in this message.) Let me know
if that expresses your intent.
I gather from looking at your site that the "Guided Tour" per se is an
HTML document; this package includes the slides from your lectures. I
plan to update, so comments would be appreciated.
You can install the package under GNU Emacs, but the auto-menu
installation and auto-location of data probably won't work. I'd be
curious if the rest works, but you may need to do some banging. Note
that I do have an assignment for XEmacs on file, so you can submit
code based on this code to GNU Emacs (after checking with rms) without
any legal problems that I know of.
XEmacs developers: This package sort of violates the convention about
auto-autoloading doing nothing, since it "insinuates" the menu. That
seems harmless to me, though.
Lightly tested.
;;; guided-tour.el --- functions for viewing Phil Sung's Emacs Guided Tour
;; Copyright 2007 Free Software Foundation, Inc.
;; Author: Stephen J. Turnbull <stephen(a)xemacs.org>
;; Maintainer: XEmacs Development Team
;; Created: 2007-05-02
;; Keywords: doc
;; The permissions notice is contained in the function
;; `guided-tour-about' at the end of this file. Under the terms
;; granted, you may modify that function, but the appropriate
;; permissions notice must remain in this file somewhere.
;;; Synched up with: Not in FSF.
;;; Commentary:
;; Thanks to Jason Spiro and Phil Sung for making substantial effort
;; to make this content as useful to XEmacs as possible.
;;; Code:
;; Variables
(defgroup guided-tour nil "Phil Sung's Emacs Guided Tour")
(defcustom guided-tour-odp-viewer "ooimpress"
"Path to program able to view Open Document Format presentations.
Program is invoked in a shell, so PATH is searched."
:type '(choice string
(const "ooimpress")
(const "open" :doc "Useful on Mac OS X"))
:group 'guided-tour)
(defcustom guided-tour-pdf-viewer "xpdf"
"Path to program able to view Portable Document Format documents.
Program is invoked in a shell, so PATH is searched."
:type '(choice string
(const "xpdf")
(const "gv")
(const "open" :doc "Useful on Mac OS X"))
:group 'guided-tour)
(defconst guided-tour-submenu
'("A Guided Tour of Emacs"
["Guided Tour, Part %_1 (OOo)" guided-tour-odp-1]
["Guided Tour, Part %_2 (OOo)" guided-tour-odp-2]
["Guided Tour, Part %_3 (OOo)" guided-tour-odp-3]
["Guided Tour, Part %_1 (PDF)" guided-tour-pdf-1]
["Guided Tour, Part %_2 (PDF)" guided-tour-pdf-2]
["Guided Tour, Part %_3 (PDF)" guided-tour-pdf-3]
["About COPYING the Tour" guided-tour-about])
"The submenu for Phil Sung's \"Guided Tour of Emacs\".")
(defvar guided-tour-insinuate-menubar nil
"If non-nil, inhibits insinuation of the menubar.
Note that if you make this nil and reinsinuate, you are responsible for
removing any existing instances of the submenu.")
;; Functions
;; Helper functions
;; #### this probably should move to help.el or menubar-items.el
(defun guided-tour-find-menubar-help-menu (&optional menubar)
"Return the Help submenu for MENUBAR if present, else nil."
(assoc "%_Help" (or menubar default-menubar)))
(defun guided-tour-about-xemacs-index (menu)
"Return the (zero-based) index of the About XEmacs item in MENU.
Returns nil if not present."
;; #### Of course we should actually search for it....
;; Does easy-menu provide functions for this? It should....
(let ((item (cadr menu)))
(if (and (vectorp item) (eq 'about-xemacs (aref item 1)))
0
nil)))
;; Initialization
;;;###autoload
(defun guided-tour-insinuate-menubar ()
"Add Phil Sung's Guided Tour of Emacs to the default menubar."
(unless guided-tour-insinuate-menubar
(setq guided-tour-insinuate-menubar t)
(let* ((help (guided-tour-find-menubar-help-menu)))
(setcdr help (nconc (if (eq 0 (guided-tour-about-xemacs-index help))
(list (cadr help) guided-tour-submenu)
(list guided-tour-submenu (cadr help)))
(cddr help))))))
;; Is this OK? Don't see how it really hurts.
;;;###autoload
(guided-tour-insinuate-menubar)
;; The Guided Tour
(defun guided-tour (type part)
"Start the Guided Tour with TYPE viewer, in Part PART."
(interactive "sWhich format? \nnWhich part? ")
(let ((viewer (symbol-value (intern (concat "guided-tour-" type
"-viewer"))))
(file (format "emacs-slides-%d.%s" part type)))
(message "\
`M-x guided-tour-about RET' for FAQ and licensing.")
(shell-command (format "%s %s" viewer (or (locate-data-file file) file)))))
(defun guided-tour-odp-1 ()
"Start up the Guided Tour of Emacs, part 1, as an Open Office presentation."
(interactive)
(guided-tour "odp" 1))
(defun guided-tour-odp-2 ()
"Start up the Guided Tour of Emacs, part 2, as an Open Office presentation."
(interactive)
(guided-tour "odp" 2))
(defun guided-tour-odp-3 ()
"Start up the Guided Tour of Emacs, part 3, as an Open Office presentation."
(interactive)
(guided-tour "odp" 3))
(defun guided-tour-pdf-1 ()
"Start up the Guided Tour of Emacs, part 1, in a PDF viewer."
(interactive)
(guided-tour "pdf" 1))
(defun guided-tour-pdf-2 ()
"Start up the Guided Tour of Emacs, part 2, in a PDF viewer."
(interactive)
(guided-tour "pdf" 2))
(defun guided-tour-pdf-3 ()
"Start up the Guided Tour of Emacs, part 3, in a PDF viewer."
(interactive)
(guided-tour "pdf" 3))
(defun guided-tour-about ()
"Document the Guided Tour."
(interactive)
(with-displaying-temp-buffer "*About the Guided Tour of Emacs*"
(princ "\
A Guided Tour of Emacs
Phil Sung
This is the XEmacs package of the Guided Tour of Emacs.
The slides are by Phil Sung. That's the important part. Send kudos to Phil.
The XEmacs package is by Stephen Turnbull. Direct complaints about packaging
to Steve via the XEmacs Developers mailing list <xemacs-beta(a)xemacs.org>.
The FAQ follows the permissions notice.
Copyright 2007 The Free Software Foundation Inc.
The Guided Tour, is both free software and free content.
You can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation;
either version 2, or (at your option) any later version published by
the Free Software Foundation.
You can redistribute it and/or modify it under the terms of GNU Free
Documentation License; either version 1.2, or (at your option) any
later version published by the Free Software Foundation.
A verbatim or modified version can be redistributed under both
licenses simultaneously, which is the authors' preferred method.
The Guided Tour is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License and/or the GNU Free Documentation License for more
details.
FAQ
Q1. I select a tour from the menu, but nothing happens!
A1. You probably need to configure a viewer. C-h v guided-tour-pdf-viewer RET
or C-h v guided-tour-odp-viewer RET.
"
;; #### Find web, C-h, and maybe file locations for licenses, then add above.
;; You should have received a copy of the GNU General Public License
;; along with XEmacs; see the file COPYING. If not, write to the
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
;; Boston, MA 02111-1307, USA.
)))
;;; guided-tour.el ends here
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
2:19 p.m.
Stephen J. Turnbull writes:
Phil, I attach the ChangeLog and the infrastructure Lisp for making
the Guided Tour available in the Help menu. Please check the
following points:
Urk, I forgot the ChangeLog, my wife called me to dinner and I just
hit C-c C-c to avoid drooling on the keyboard....
Here it is
2007-05-03 Stephen J. Turnbull <stephen(a)xemacs.org>
Create package.
* emacs-slides-1.odp:
* emacs-slides-2.odp:
* emacs-slides-3.odp:
* emacs-slides-1.pdf:
* emacs-slides-2.pdf:
* emacs-slides-3.pdf:
Import Phil Sung's "Guided Tour" content, from
http://stuff.mit.edu/iap/emacs/ ＠2007-02-18T09:15.
Note: Phil graciously licensed these to XEmacs under the MIT/X11
license allowing us to use *these versions only* in any way we
might want to inside of XEmacs (specifically, we can freely use
this content in our Texinfo manuals), but asks that we distribute
only under the GPL or GFDL or both. The content is copyright-
assigned to the FSF, and is publicly licensed only under the GPL
and GFDL (as of this writing). When in doubt as to the intent of
the permissions for use of content, ask Phil first, don't rely on
the letter of the law or licenses.
* package-info.in:
* Makefile:
* ChangeLog:
New. Package infrastructure.
* guided-tour.el:
New. Menuing infrastructure.
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
9:25 p.m.
2007/5/3, Stephen J. Turnbull <stephen(a)xemacs.org> wrote:
[snip]
(defcustom guided-tour-pdf-viewer "xpdf"
"Path to program able to view Portable Document Format documents.
Program is invoked in a shell, so PATH is searched."
:type '(choice string
(const "xpdf")
(const "gv")
(const "open" :doc "Useful on Mac OS X"))
:group 'guided-tour)
Stephen, it was very kind of you to write this Lisp code. I have not
tested it but it looks very cool.
One thing: why not call the Linux program see(1) by default? It looks
in the mailcap file to figure out what program to call. (On my Ubuntu
machine, it launches Evince, which IMO is an easier-to-use, more
modern-looking, and more convenient PDF viewer than xpdf.) There's
also gnome-open(1) but IIRC it didn't work for me.
Also: Why give the user a choice of ODT or PDF? I think you should
open the PDF by default. If they really need the ODT maybe they can
look on disk or, if you feel it's important, you could add an option
for ESC 1 M-x guided-tour to open it.
Cheers,
Jason
--
Jason Spiro: computer consulting with a smile.
I provide software development and training services to clients worldwide.
Contact me for a FREE consultation. Satisfaction guaranteed.
+1 (416) 781-5938 / Email: info(a)jspiro.com / MSN: jasonspiro(a)hotmail.com
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
5:37 a.m.
Jason Spiro writes:
One thing: why not call the Linux program see(1) by default?
$ which see
which: no see in
(/usr/local/bin:/usr/bin:/bin:/opt/bin:/usr/x86_64-pc-linux-gnu/gcc-bin/3.4.6:/opt/ghc/bin:/usr/kde/3.5/bin:/usr/qt/3/bin)
$ q.v.
/bin/bash: q.v.: command not found
<wink>
AFAIK most Unix platforms do have xpdf somewhere.
There's also gnome-open(1) but IIRC it didn't work for me.
Right. I put in things that *I* tested, and I suspect that there are
probably still more users of XEmacs on non-Linux platforms (eg,
Windows) than on Linux. I'll add "see" and "gnome-open" as
choices in
the next version, but defaults are hard to get right, and can do harm
(eg, to my free time) if wrong.
Also: Why give the user a choice of ODT or PDF?
Because it's there. If there's strong preference among users for PDF
(or HTML, when we get around to adding it), we can default to that
then. So far the vote is PDF 2, ODP 0. That's not a quorum.<wink>
If they really need the ODT maybe they can look on disk
Why should they, when XEmacs already knows where it is? Uncluttering
the menu is one thing (there could be yet another level, with an "Other
Formats" submenu). But making users work unnecessarily is uncool.
or, if you feel it's important, you could add an option
for ESC 1 M-x guided-tour to open it.
M-x guided-tour already prompts for format and part. Those can be
defaulted appropriately later (in particular, `guided-tour' should
remember the previous format, and also increment the part by default).
But I expect that most users will find it in the Help menu.
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
7:28 a.m.
On Friday 04 May 2007, Stephen J. Turnbull wrote:
Right. I put in things that *I* tested, and I suspect that there
are
probably still more users of XEmacs on non-Linux platforms (eg,
Windows) than on Linux. I'll add "see" and "gnome-open" as
choices in
the next version, but defaults are hard to get right, and can do harm
(eg, to my free time) if wrong.
xdg-open would be a good choice to add too, even to or near the beginning of
list of tried things. http://portland.freedesktop.org/wiki/XdgUtils
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
9:37 a.m.
Ville Skyttä writes:
Have you tried it? What do you think?
xdg-open would be a good choice to add too, even to or near the
beginning of
list of tried things. http://portland.freedesktop.org/wiki/XdgUtils
Done. I append the current scheme. As I told Jason, I'm more
interested in completeness at this stage than in getting defaults, let
alone precedence, right. Once I get it into CVS, I don't plan to be
particularly possessive about it, unless people get into a patchwar
over the defaults or the order of menu items.
;; #### this belongs somewhere more generic
;; #### it would be nice to be able to filter it for platform
;; #### The docstrings don't appear in the Value Menu. Tried the menu-choice
;; widget and the :tag and :menu-tag keywords in various combinations, no joy.
(defcustom guided-tour-open-utilities
'((const "open" :doc "Useful on Mac OS X")
(const "xdg-open" :doc "Freedesktop `open' utility.")
(const "see" :doc "Open source `open' utility")
(const "gnome-open"
:doc "GNOME `open' utility - some report it doesn't work"))
"List of generic \"open document\" command-line utilities.
Each utility should be able to determine the right application to use to open
an arbitrary file passed to it on the command line.")
(defcustom guided-tour-odp-viewer "ooimpress"
"Path to program able to view Open Document Format presentations.
Program is invoked in a shell, so PATH is searched."
:type (append '(choice string
(const "ooimpress"))
guided-tour-open-utilities)
:group 'guided-tour)
(defcustom guided-tour-pdf-viewer "xpdf"
"Path to program able to view Portable Document Format documents.
Program is invoked in a shell, so PATH is searched."
:type (append '(choice string
(const "xpdf")
(const "gv"))
guided-tour-open-utilities)
:group 'guided-tour)
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
1:47 a.m.
"Jason Spiro" <jasonspiro4(a)gmail.com> writes:
2007/5/3, Stephen J. Turnbull <stephen(a)xemacs.org> wrote:
[snip]
> (defcustom guided-tour-pdf-viewer "xpdf"
> "Path to program able to view Portable Document Format documents.
> Program is invoked in a shell, so PATH is searched."
>:type '(choice string
> (const "xpdf")
> (const "gv")
> (const "open" :doc "Useful on Mac OS X"))
>:group 'guided-tour)
Stephen, it was very kind of you to write this Lisp code. I have not
tested it but it looks very cool.
One thing: why not call the Linux program see(1) by default? It looks
in the mailcap file to figure out what program to call.
It would seem more straightforward to call mailcap-mime-info for that.
--
David Kastrup, Kriemhildstr. 15, 44793 Bochum
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
8:26 a.m.
* "Stephen J. Turnbull" <stephen(a)xemacs.org>:
Hi!
Phil Sung writes:
> Presumably if we had a dedicated wiki for this, we could require that
> contributions be tri-licensed (just as Wikipedia requires that
> contributions be GFDL'd). But the FSF would still want copyright
> assignments in either case if it were going to ship a wiki version, so
> I think using Wikimedia is just fine now.
[Note: Since Phil posted this, he has indicated in private mail that
he wishes to restrict redistribution to the GPL and GFDL terms.]
I have created an XEmacs package, but was unable to "cvs add" the
directory, not having sufficient permission. Norbert, do you know
what's going on here? Can you help with this or tell me how to do it?
A packagized tarball is available at
http://turnbull.sk.tsukuba.ac.jp/Tools/XEmacs/guided-tour/
The sources (for Norbert if he needs it, others probably want to wait
for CVS), package-index, and Windows setup-packages.ini are also
available there.
I haven't tried to cvs add something as of lately, so I don't know if
the permissions have been changed.
Should I grab the tarball and try to add it? It's to be part of
xemacs-packages, isn't it?
Thanks,
norbert.
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
10:31 a.m.
Norbert Koch writes:
* "Stephen J. Turnbull" <stephen(a)xemacs.org>:
> I have created an XEmacs package, but was unable to "cvs
add" the
> directory, not having sufficient permission. Norbert, do you know
> what's going on here? Can you help with this or tell me how to do it?
>
Should I grab the tarball and try to add it? It's to be part of
xemacs-packages, isn't it?
No, thanks. I figured it out; I had a :pserver: CVSROOT. d'oh.
I'll be submitting a patch for the non-binaries, and committing,
shortly.
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
10:11 p.m.
Hi Stephen,
Thanks for writing this code to integrate the Guided Tour.
"Stephen J. Turnbull" <stephen(a)xemacs.org> writes:
Please check the following points:
1. Use of your name. Tastes differ, and you may want more or less
credits. I wish to respect your tastes. :-)
I think it sounds odd to preface most instances of "Guided Tour" with
"Phil
Sung's". I've attached a patch that removes some of them. :)
2. Check the comments about permissions in the ChangeLog. If you
have qualms about it, let me know.
From the ChangeLog:
Note: Phil graciously licensed these to XEmacs under the MIT/X11
license
allowing us to use *these versions only* in any way we might want to inside
of XEmacs (specifically, we can freely use this content in our Texinfo
manuals), but asks that we distribute only under the GPL or GFDL or both. The
content is copyright- assigned to the FSF, and is publicly licensed only
under the GPL and GFDL (as of this writing). When in doubt as to the intent
of the permissions for use of content, ask Phil first, don't rely on the
letter of the law or licenses.
That's perfectly fine. I think as long as it is clear that the present versions
may be used under the MIT/X11 license (and therefore can be integrated into the
Texinfo manuals), and future improvements are GPL|GFDL only, there should be
little ambiguity. Perhaps that last caveat is not necessary.
What's the plan with respect to picking up future versions? Are you going to
keep the X11-licensed version around and import future GPL|GFDL versions
alongside it? I suppose that does not have to be thought about right now.
3. Check the permissions notice in the function
`guided-tour-about'
in the Lisp. (It's the last thing in this message.) Let me know
if that expresses your intent.
It looks great.
You can install the package under GNU Emacs, but the auto-menu
installation and auto-location of data probably won't work. I'd be
curious if the rest works, but you may need to do some banging. Note
that I do have an assignment for XEmacs on file, so you can submit
code based on this code to GNU Emacs (after checking with rms) without
any legal problems that I know of.
I will play around with GNU Emacs integration when I get a chance.
For what it's worth, the HTML version has been picked up by gnu.org:
<http://www.gnu.org/software/emacs/tour/>
Again, thanks for packaging all this up.
Cheers,
Phil
------
*** /home/phil/src/guided-tour-xemacs/lisp/guided-tour/guided-tour.el 2007-05-03
04:21:09.000000000 -0400
--- /tmp/buffer-content-4834T3x 2007-05-03 17:26:58.000000000 -0400
***************
*** 23,29 ****
;; Variables
! (defgroup guided-tour nil "Phil Sung's Emacs Guided Tour")
(defcustom guided-tour-odp-viewer "ooimpress"
"Path to program able to view Open Document Format presentations.
--- 23,29 ----
;; Variables
! (defgroup guided-tour nil "The Emacs Guided Tour")
(defcustom guided-tour-odp-viewer "ooimpress"
"Path to program able to view Open Document Format presentations.
***************
*** 51,57 ****
["Guided Tour, Part %_2 (PDF)" guided-tour-pdf-2]
["Guided Tour, Part %_3 (PDF)" guided-tour-pdf-3]
["About COPYING the Tour" guided-tour-about])
! "The submenu for Phil Sung's \"Guided Tour of Emacs\".")
(defvar guided-tour-insinuate-menubar nil
"If non-nil, inhibits insinuation of the menubar.
--- 51,57 ----
["Guided Tour, Part %_2 (PDF)" guided-tour-pdf-2]
["Guided Tour, Part %_3 (PDF)" guided-tour-pdf-3]
["About COPYING the Tour" guided-tour-about])
! "The submenu for the \"Guided Tour of Emacs\".")
(defvar guided-tour-insinuate-menubar nil
"If non-nil, inhibits insinuation of the menubar.
***************
*** 81,87 ****
;;;###autoload
(defun guided-tour-insinuate-menubar ()
! "Add Phil Sung's Guided Tour of Emacs to the default menubar."
(unless guided-tour-insinuate-menubar
(setq guided-tour-insinuate-menubar t)
(let* ((help (guided-tour-find-menubar-help-menu)))
--- 81,87 ----
;;;###autoload
(defun guided-tour-insinuate-menubar ()
! "Add the Guided Tour of Emacs to the default menubar."
(unless guided-tour-insinuate-menubar
(setq guided-tour-insinuate-menubar t)
(let* ((help (guided-tour-find-menubar-help-menu)))
_______________________________________________
XEmacs-Beta mailing list
XEmacs-Beta(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-beta
6411
days inactive
6434
days old
18 comments
8 participants
participants (8)
-
David Kastrup -
Jason A. Spiro -
Jason Spiro -
Norbert Koch -
Phil Sung -
Phil Sung
-
Stephen J. Turnbull -
Ville Skyttä