emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* org manual not updating when pulling from git
@ 2017-02-07 18:38 Charles Millar
  2017-02-07 19:41 ` Nick Dokos
  0 siblings, 1 reply; 9+ messages in thread
From: Charles Millar @ 2017-02-07 18:38 UTC (permalink / raw)
  To: emacs-orgmode@gnu.org

When pulling from git, shouldn't the manual be updated if for no other 
reason than to refelct the most recent org version?

Up unitl two or three days ago, this was my experience. Now, however, 
none of the documentation seems to be updating, e g.

current Org mode version 9.0.4 (release_9.0.4-283-g2064b0 @ 
/usr/local/share/emacs/site-lisp/org-mode/lisp/)

pdf manual shows version Release 9.0.4 (release 9.0.4-263-gf15728)

As far as I know I have not changed any settings on my end.

Charlie MIllar

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-07 18:38 org manual not updating when pulling from git Charles Millar
@ 2017-02-07 19:41 ` Nick Dokos
  2017-02-07 20:35   ` Achim Gratz
  2017-02-07 23:59   ` Charles Millar
  0 siblings, 2 replies; 9+ messages in thread
From: Nick Dokos @ 2017-02-07 19:41 UTC (permalink / raw)
  To: emacs-orgmode

Charles Millar <millarc@verizon.net> writes:

> When pulling from git, shouldn't the manual be updated if for no other
> reason than to refelct the most recent org version?
>

It depends on what you mean by "the manual" - the texinfo source is updated,
but any derived files (info, pdf) are not: they are not under source control
at all.

> Up unitl two or three days ago, this was my experience. Now, however,
> none of the documentation seems to be updating, e g.
>
> current Org mode version 9.0.4 (release_9.0.4-283-g2064b0 @
> /usr/local/share/emacs/site-lisp/org-mode/lisp/)
>
> pdf manual shows version Release 9.0.4 (release 9.0.4-263-gf15728)
>

"make doc" or "make pdf" will update the PDF file. If you use one of
the update targets in the makefile, it may have been updating the pdf
doc under the covers. Taking a look through recent commits, the only one
that might be relevant seems to be this:

,----
| commit c90c7a33f53ad88dfcc583ad4c77bec306da0b22
| Author: Marco Wahl <marcowahlsoft@gmail.com>
| Date:   Wed Feb 1 11:16:16 2017 +0100
| 
|     targets.mk: Drop the rule to clean at every compile
|     
|     Rationale: 1. Save time and energy.  2. Use the make tool for what
|     it's been made.
`----

So, how do you update?

-- 
Nick

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-07 19:41 ` Nick Dokos
@ 2017-02-07 20:35   ` Achim Gratz
  2017-02-07 23:01     ` Marco Wahl
  2017-02-07 23:59   ` Charles Millar
  1 sibling, 1 reply; 9+ messages in thread
From: Achim Gratz @ 2017-02-07 20:35 UTC (permalink / raw)
  To: emacs-orgmode

Nick Dokos writes:
> "make doc" or "make pdf" will update the PDF file. If you use one of
> the update targets in the makefile, it may have been updating the pdf
> doc under the covers. Taking a look through recent commits, the only one
> that might be relevant seems to be this:
>
> ,----
> | commit c90c7a33f53ad88dfcc583ad4c77bec306da0b22
> | Author: Marco Wahl <marcowahlsoft@gmail.com>
> | Date:   Wed Feb 1 11:16:16 2017 +0100
> | 
> |     targets.mk: Drop the rule to clean at every compile
> |     
> |     Rationale: 1. Save time and energy.  2. Use the make tool for what
> |     it's been made.
> `----

That commit should probably be reverted.  The make tool can't do what
it's been made for in this case since some of the dependencies can not
be correctly determined.  You can still skip the clean if you want to by
using the compile-dirty target.


Regards,
Achim.
-- 
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

Wavetables for the Terratec KOMPLEXER:
http://Synth.Stromeko.net/Downloads.html#KomplexerWaves

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-07 20:35   ` Achim Gratz
@ 2017-02-07 23:01     ` Marco Wahl
  2017-02-08 18:43       ` Achim Gratz
  0 siblings, 1 reply; 9+ messages in thread
From: Marco Wahl @ 2017-02-07 23:01 UTC (permalink / raw)
  To: emacs-orgmode

Hi!

Achim Gratz <Stromeko@nexgo.de> writes:

> Nick Dokos writes:
>> "make doc" or "make pdf" will update the PDF file. If you use one of
>> the update targets in the makefile, it may have been updating the pdf
>> doc under the covers. Taking a look through recent commits, the only one
>> that might be relevant seems to be this:
>>
>> ,----
>> | commit c90c7a33f53ad88dfcc583ad4c77bec306da0b22
>> | Author: Marco Wahl <marcowahlsoft@gmail.com>
>> | Date:   Wed Feb 1 11:16:16 2017 +0100
>> |
>> |     targets.mk: Drop the rule to clean at every compile
>> |
>> |     Rationale: 1. Save time and energy.  2. Use the make tool for what
>> |     it's been made.
>> `----
>
> That commit should probably be reverted.  The make tool can't do what
> it's been made for in this case since some of the dependencies can not
> be correctly determined.  You can still skip the clean if you want to by
> using the compile-dirty target.

Ah!  I didn't see target 'compile-dirty'.  Thank you for the hint.

So for now I'm happy with the build process with the existence of

    make compile-dirty

and further

    make test-dirty

Also the names are well chosen AFAICT.

I agree that the commit should be reverted and I already did the revert.
Please accept my apology for the irritation about the build behavior.


Best regards

                       Marco
                       

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-07 19:41 ` Nick Dokos
  2017-02-07 20:35   ` Achim Gratz
@ 2017-02-07 23:59   ` Charles Millar
  2017-02-08 16:39     ` Nick Dokos
  1 sibling, 1 reply; 9+ messages in thread
From: Charles Millar @ 2017-02-07 23:59 UTC (permalink / raw)
  To: emacs-orgmode

Hi,


On 02/07/2017 02:41 PM, Nick Dokos wrote:
> Charles Millar <millarc@verizon.net> writes:
>
>> When pulling from git, shouldn't the manual be updated if for no other
>> reason than to refelct the most recent org version?
>>
> It depends on what you mean by "the manual" - the texinfo source is updated,
> but any derived files (info, pdf) are not: they are not under source control
> at all.
>
>> Up unitl two or three days ago, this was my experience. Now, however,
>> none of the documentation seems to be updating, e g.
>>
>> current Org mode version 9.0.4 (release_9.0.4-283-g2064b0 @
>> /usr/local/share/emacs/site-lisp/org-mode/lisp/)
>>
>> pdf manual shows version Release 9.0.4 (release 9.0.4-263-gf15728)
>>
> "make doc" or "make pdf" will update the PDF file. If you use one of
> the update targets in the makefile, it may have been updating the pdf
> doc under the covers. Taking a look through recent commits, the only one
> that might be relevant seems to be this:
>
> ,----
> | commit c90c7a33f53ad88dfcc583ad4c77bec306da0b22
> | Author: Marco Wahl <marcowahlsoft@gmail.com>
> | Date:   Wed Feb 1 11:16:16 2017 +0100
> |
> |     targets.mk: Drop the rule to clean at every compile
> |
> |     Rationale: 1. Save time and energy.  2. Use the make tool for what
> |     it's been made.
> `----
>
> So, how do you update?
>
I forgot about make doc; in the past I used it whenever I had to 
recompile org from source; after that the pdf "just updated" each time I 
pulled from git.

Charlie

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-07 23:59   ` Charles Millar
@ 2017-02-08 16:39     ` Nick Dokos
  2017-02-08 16:54       ` Charles Millar
  0 siblings, 1 reply; 9+ messages in thread
From: Nick Dokos @ 2017-02-08 16:39 UTC (permalink / raw)
  To: emacs-orgmode

Charles Millar <millarc@verizon.net> writes:

>> So, how do you update?
>>
> I forgot about make doc; in the past I used it whenever I had to
> recompile org from source; after that the pdf "just updated" each time
> I pulled from git.
>

The question was: *how* do you pull from git? If you use one of the make
targets (e.g. make update), that's one thing; but if you use "git pull" or
some variant thereof that does *not* involve make, then the pdf would *not*
"just update" (unless you've set up some git hook to do some post-processing).

-- 
Nick

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-08 16:39     ` Nick Dokos
@ 2017-02-08 16:54       ` Charles Millar
  2017-02-08 18:35         ` Marco Wahl
  0 siblings, 1 reply; 9+ messages in thread
From: Charles Millar @ 2017-02-08 16:54 UTC (permalink / raw)
  To: emacs-orgmode



On 02/08/2017 11:39 AM, Nick Dokos wrote:
> Charles Millar <millarc@verizon.net> writes:
>
>>> So, how do you update?
>>>
>> I forgot about make doc; in the past I used it whenever I had to
>> recompile org from source; after that the pdf "just updated" each time
>> I pulled from git.
>>
> The question was: *how* do you pull from git? If you use one of the make
> targets (e.g. make update), that's one thing; but if you use "git pull" or
> some variant thereof that does *not* involve make, then the pdf would *not*
> "just update" (unless you've set up some git hook to do some post-processing).
>
I use make update. Now it is "working" as before.

Charlie

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-08 16:54       ` Charles Millar
@ 2017-02-08 18:35         ` Marco Wahl
  0 siblings, 0 replies; 9+ messages in thread
From: Marco Wahl @ 2017-02-08 18:35 UTC (permalink / raw)
  To: emacs-orgmode

Charles Millar <millarc@verizon.net> writes:
> I use make update. Now it is "working" as before.

Good!  This indicates that the revert of the commit in question has been
applied.

This is the commit message:

#v+
     Revert commit c90c7a33f53ad88dfcc583ad4c77bec306da0b22

     targets.mk: Revert to cleanup at every compile for 'standard' targets.

     Note: You can do 'dirty' builds with 'make compile-dirty' and 'make
     test-dirty'.
     - Disadvantage: these builds may fail due to the missing clean.
     - Advantage: typically the 'dirty' builds are much faster.
#v-


Best regards

                       Marco

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: org manual not updating when pulling from git
  2017-02-07 23:01     ` Marco Wahl
@ 2017-02-08 18:43       ` Achim Gratz
  0 siblings, 0 replies; 9+ messages in thread
From: Achim Gratz @ 2017-02-08 18:43 UTC (permalink / raw)
  To: emacs-orgmode

Marco Wahl writes:
> Ah!  I didn't see target 'compile-dirty'.  Thank you for the hint.
>
> So for now I'm happy with the build process with the existence of
>
>     make compile-dirty
>
> and further
>
>     make test-dirty
>
> Also the names are well chosen AFAICT.
>
> I agree that the commit should be reverted and I already did the revert.
> Please accept my apology for the irritation about the build behavior.

No problem.  But in the future, please ask here first if you think you
find something in the build system that you can optimize.  Maybe it was
an oversight or it's a workaround that has become obsolete, but usually
there's an actual reason behind.


Regards,
Achim.
-- 
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

SD adaptation for Waldorf rackAttack V1.04R1:
http://Synth.Stromeko.net/Downloads.html#WaldorfSDada

^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2017-02-08 18:43 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-02-07 18:38 org manual not updating when pulling from git Charles Millar
2017-02-07 19:41 ` Nick Dokos
2017-02-07 20:35   ` Achim Gratz
2017-02-07 23:01     ` Marco Wahl
2017-02-08 18:43       ` Achim Gratz
2017-02-07 23:59   ` Charles Millar
2017-02-08 16:39     ` Nick Dokos
2017-02-08 16:54       ` Charles Millar
2017-02-08 18:35         ` Marco Wahl

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).