contrib/README

contrib/README

[Stephen Eglen]

contrib/README seems out of date; in particular this file I was
interested in seeing has gone:

org-R.el                 --- Computation using the R language

Questions:

- how do I query git to find out where this file has gone?

- who maintains README?  Or should I check them all and send a patch?

Stephen

Re: contrib/README

[Carsten Dominik]

On Jul 1, 2010, at 11:01 AM, Stephen Eglen wrote:

> contrib/README seems out of date; in particular this file I was
> interested in seeing has gone:
>
> org-R.el                 --- Computation using the R language
>
> Questions:
>
> - how do I query git to find out where this file has gone?

This one was removed because its functionality is included in Org babel.
Files added and removed are usually listed in the list of user visible  
changes.
I am not sure how to find it in git.

>
> - who maintains README?  Or should I check them all and send a patch?

A patch to update the README file would be appreciated.


- Carsten

>
> Stephen
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten

Re: contrib/README

[Stephen Eglen]

Thanks Carsten;

Carsten Dominik <carsten.dominik@gmail.com> wrote:

> This one was removed because its functionality is included in Org babel.
> Files added and removed are usually listed in the list of user visible
> changes.
> I am not sure how to find it in git.

I think I just found at least somethign (sorry, I'm new at git); "git
log" within the contrib/lisp directory showed me indeed that it was
removed on 31 Mar this year.


> A patch to update the README file would be appreciated.

will do (soonish).

S

Re: contrib/README

[Stephen Eglen]

[-- Attachment #1: Type: text/plain, Size: 119 bytes --]

Here is a patch for contrib/README.  I've not included though any
mention of the new babel folder in contrib.

Stephen

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: carsten-patch --]
[-- Type: text/x-diff, Size: 3792 bytes --]

diff --git a/contrib/ChangeLog b/contrib/ChangeLog
index 44db137..af18a84 100644
--- a/contrib/ChangeLog
+++ b/contrib/ChangeLog
@@ -1,3 +1,9 @@
+2010-07-01  Stephen Eglen  <stephen@gnu.org>
+
+	* README: Update list of emacs-lisp files so that list is in
+	sync with the files in lisp/ and in same order as 'ls -1' for
+	those files.
+
 2010-05-11  Carsten Dominik  <carsten.dominik@gmail.com>
 
 	* lisp/org-git-link.el (org-git-open)
diff --git a/contrib/README b/contrib/README
index bdc93d3..f8fe423 100644
--- a/contrib/README
+++ b/contrib/README
@@ -9,9 +9,11 @@ Please put your contribution in one of these three directories:
 
 LISP (emacs-lisp code)
 ======================
-
+htmlize.el               --- Convert buffer text and decorations to HTML
+org2rem.el               --- Convert org appointments into reminders
 org-annotate-file.el     --- Annotate a file with org syntax
 org-bookmark.el          --- Links to bookmarks
+org-checklist.el         --- org functions for checklist handling
 org-choose.el            --- Use TODO keywords to mark decision states
 org-collector.el         --- Collect properties into tables
 org-contribdir.el        --- Dummy file to mark the org contrib Lisp directory
@@ -19,29 +21,30 @@ org-depend.el            --- TODO dependencies for Org-mode
 org-elisp-symbol.el      --- Org links to emacs-lisp symbols
 org-eval.el              --- The <lisp> tag, adapted from Muse
 org-eval-light.el        --- Evaluate in-buffer code on demand
-org-expiry.el 	         --- Expiry mechanism for Org entries
 org-exp-bibtex.el        --- Export citations to LaTeX and HTML
+org-expiry.el 	         --- Expiry mechanism for Org entries
 org-export-generic.el    --- Export framework for configurable backends
 org-git-link.el          --- Provide org links to specific file version
 org-interactive-query.el --- Interactive modification of tags query
 org-invoice.el           --- Help manage client invoices in OrgMode
 org-jira.el              --- Add a jira:ticket protocol to Org
 org-learn.el             --- SuperMemo's incremental learning algorithm
-org-mairix.el 	         --- Hook mairix search into Org for different MUAs
 org-mac-iCal.el          --- Imports events from iCal.app to the Emacs diary
 org-mac-link-grabber.el  --- Grab links and URLs from various Mac applications
+org-mairix.el 	         --- Hook mairix search into Org for different MUAs
 org-man.el 	         --- Support for links to manpages in Org-mode
+org-mime.el              --- org html export for text/html MIME emails
 org-mtags.el 	         --- Support for some Muse-like tags in Org-mode
 org-panel.el 	         --- Simple routines for us with bad memory
-org-R.el                 --- Computation using the R language
 org-registry.el          --- A registry for Org links
-org2rem.el               --- Convert org appointments into reminders
 org-screen.el            --- Visit screen sessions through Org-mode links
 org-secretary.el         --- Team management with org-mode
 org-special-blocks.el    --- Turn blocks into LaTeX envs and HTML divs
-org-track.el             --- Keep up with Org development
+orgtbl-sqlinsert.el      --- Convert Org-mode tables to SQL insertions
 org-toc.el 	         --- Table of contents for Org-mode buffer
-orgtbl-sqlinsert.el      --- Convert Org-mode tables to SQL insertions.
+org-track.el             --- Keep up with Org development
+
+
 
 PACKAGES
 ========
@@ -51,4 +54,4 @@ SCRIPTS (shell, bash, etc.)
 
 dir2org.zsh          --- Org compatible fs structure output
 org2hpda	     --- Generate hipster pda style printouts from Org-mode
-ditaa.jar            --- ASCII to PNG converter by Stathis Sideris, GPL
\ No newline at end of file
+ditaa.jar            --- ASCII to PNG converter by Stathis Sideris, GPL

[-- Attachment #3: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

Re: contrib/README

[Carsten Dominik]

On Jul 1, 2010, at 11:22 AM, Stephen Eglen wrote:

> Here is a patch for contrib/README.  I've not included though any
> mention of the new babel folder in contrib.
>
> Stephen
> <carsten-patch>

Applied, thanks.

Please that we no longer use ChangeLog, but that we place entries
with similar syntax into the commit message and then later
build ChangeLog from that.

If you look at the final commit, you'll see what I mean.

Thanks

- Carsten

Re: contrib/README

[Stephen Eglen]

> Please that we no longer use ChangeLog, but that we place entries
> with similar syntax into the commit message and then later
> build ChangeLog from that.
> 
> If you look at the final commit, you'll see what I mean.

I see - neat idea about the ChangeLog.  Can you still use 'C-x 4 a' from
a buffer to help build the ChangeLog entries though which ultimately go
in the commit messages?  What's the workflow (sorry if this has been
discussed before)?

Stephen

Re: contrib/README

[Carsten Dominik]

On Jul 1, 2010, at 2:15 PM, Stephen Eglen wrote:

>
>> Please that we no longer use ChangeLog, but that we place entries
>> with similar syntax into the commit message and then later
>> build ChangeLog from that.
>>
>> If you look at the final commit, you'll see what I mean.
>
> I see - neat idea about the ChangeLog.  Can you still use 'C-x 4 a'  
> from
> a buffer to help build the ChangeLog entries though which ultimately  
> go
> in the commit messages?  What's the workflow (sorry if this has been
> discussed before)?

The workflow is to use magit, and the to press `C' at a snippet in the
magit status buffer.  This is equivalent to `C-x 4 a'.

Please make sure that

- the commit message still has a single first line, followed by a  
newline
- after the newline, the ChangeLog entry should be placed, first line  
starting
   with a star, and no empty lines inside the block.
- After the ChangeLog block, and another empty line, you can add any  
free-form
   explanations you want - they will be discarded when building the  
ChangeLog file.

See also

http://orgmode.org/worg/org-contribute.php#sec-4

HTH

- Carsten

Re: contrib/README

[Carsten Dominik]

On Jul 1, 2010, at 2:27 PM, Carsten Dominik wrote:

>
> On Jul 1, 2010, at 2:15 PM, Stephen Eglen wrote:
>
>>
>>> Please that we no longer use ChangeLog, but that we place entries
>>> with similar syntax into the commit message and then later
>>> build ChangeLog from that.
>>>
>>> If you look at the final commit, you'll see what I mean.
>>
>> I see - neat idea about the ChangeLog.  Can you still use 'C-x 4 a'  
>> from
>> a buffer to help build the ChangeLog entries though which  
>> ultimately go
>> in the commit messages?  What's the workflow (sorry if this has been
>> discussed before)?
>
> The workflow is to use magit, and the to press `C' at a snippet in the
> magit status buffer.  This is equivalent to `C-x 4 a'.
>
> Please make sure that
>
> - the commit message still has a single first line, followed by a  
> newline

arrgh, by 2 newlines, i.e. by an empty line!

> - after the newline, the ChangeLog entry should be placed, first  
> line starting
>  with a star, and no empty lines inside the block.
> - After the ChangeLog block, and another empty line, you can add any  
> free-form
>  explanations you want - they will be discarded when building the  
> ChangeLog file.
>
> See also
>
> http://orgmode.org/worg/org-contribute.php#sec-4
>
> HTH
>
> - Carsten
>

- Carsten

Re: contrib/README

[David Maus]

Carsten Dominik wrote:

>On Jul 1, 2010, at 2:15 PM, Stephen Eglen wrote:

>>
>>> Please that we no longer use ChangeLog, but that we place entries
>>> with similar syntax into the commit message and then later
>>> build ChangeLog from that.
>>>
>>> If you look at the final commit, you'll see what I mean.
>>
>> I see - neat idea about the ChangeLog.  Can you still use 'C-x 4 a'  
>> from
>> a buffer to help build the ChangeLog entries though which ultimately  
>> go
>> in the commit messages?  What's the workflow (sorry if this has been
>> discussed before)?

>The workflow is to use magit, and the to press `C' at a snippet in the
>magit status buffer.  This is equivalent to `C-x 4 a'.

Another way, I currently use: Use C-x 4 a to record changes, when
finished yank ChangeLog entries and use C-x v v or magit to stage and
commit, past & change (indentation!) the yanked ChangeLog entries.

Best,
  -- David
-- 
OpenPGP... 0x99ADB83B5A4478E6
Jabber.... dmjena@jabber.org
Email..... dmaus@ictsoc.de

Re: contrib/README

[Karsten Heymann]

Am 01.07.2010 11:07, schrieb Carsten Dominik:
> 
> On Jul 1, 2010, at 11:01 AM, Stephen Eglen wrote:

>> - how do I query git to find out where this file has gone?
> 
> This one was removed because its functionality is included in Org babel.
> Files added and removed are usually listed in the list of user visible
> changes.
> I am not sure how to find it in git.

Should be possible with git grep or git bisect.

Yours
Karsten

Re: contrib/README

[Karsten Heymann]

Am 01.07.2010 11:07, schrieb Carsten Dominik:
> 
> On Jul 1, 2010, at 11:01 AM, Stephen Eglen wrote:

>> - how do I query git to find out where this file has gone?
> 
> This one was removed because its functionality is included in Org babel.
> Files added and removed are usually listed in the list of user visible
> changes.
> I am not sure how to find it in git.

Should be possible with git grep or git bisect.

Yours
Karsten

Re: contrib/README

[Bernt Hansen]

Carsten Dominik <carsten.dominik@gmail.com> writes:

> On Jul 1, 2010, at 11:01 AM, Stephen Eglen wrote:
>
>> contrib/README seems out of date; in particular this file I was
>> interested in seeing has gone:
>>
>> org-R.el                 --- Computation using the R language
>>
>> Questions:
>>
>> - how do I query git to find out where this file has gone?
>
> This one was removed because its functionality is included in Org babel.
> Files added and removed are usually listed in the list of user visible
> changes.
> I am not sure how to find it in git.

$ git log --diff-filter=D -- contrib/lisp/org-R.el

-Bernt