emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* BUG - org-agenda-show-future-repeats not mentioned in org.pdf
@ 2017-09-09  9:05 Sharon Kimble
  2017-09-09 16:19 ` Nicolas Goaziou
  0 siblings, 1 reply; 4+ messages in thread
From: Sharon Kimble @ 2017-09-09  9:05 UTC (permalink / raw)
  To: Org Mode List

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


Seeing this new variable I've been trying to set it up to stop all the
future displays of each and every task being displayed in my 31 days
agenda.

I've updated my git/org-mode and then built the new 'org.pdf', opened it
and then had a quick browse for 'org-agenda-show-future-repeats'. I then
did a search of the whole file and it isn't mentioned at all!

I was hoping to see something which showed how to use it, as currently I
have each and every repeat showing for each and every day of my 31-day
agenda. I've tried -

--8<---------------cut here---------------start------------->8---
(setq org-agenda-show-future-repeats n)

OR

(setq org-agenda-show-future-repeats 0)

OR

(setq org-agenda-show-future-repeats 1)
--8<---------------cut here---------------end--------------->8---

But I still can't disable *all* my repeats showing for every day. 

If we have changes, especially major ones like this, could they not be
mentioned in the org.pdf with perhaps a new chapter titled 'Changes' and
then giving details of how to use the new commands, please?

I do have another bug that's irritating me, but that's for a separate post.

Thanks
Sharon.
-- 
A taste of linux = http://www.sharons.org.uk
TGmeds = http://www.tgmeds.org.uk
DrugFacts = https://www.drugfacts.org.uk  
Debian 9.0, fluxbox 1.3.5-2, emacs 25.1.1, org-mode 9.1

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

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

* Re: BUG - org-agenda-show-future-repeats not mentioned in org.pdf
  2017-09-09  9:05 BUG - org-agenda-show-future-repeats not mentioned in org.pdf Sharon Kimble
@ 2017-09-09 16:19 ` Nicolas Goaziou
  2017-09-10 10:54   ` Sharon Kimble
  0 siblings, 1 reply; 4+ messages in thread
From: Nicolas Goaziou @ 2017-09-09 16:19 UTC (permalink / raw)
  To: Sharon Kimble; +Cc: Org Mode List

Hello,

Sharon Kimble <boudiccas@skimble.plus.com> writes:

> Seeing this new variable I've been trying to set it up to stop all the
> future displays of each and every task being displayed in my 31 days
> agenda.
>
> I've updated my git/org-mode and then built the new 'org.pdf', opened it
> and then had a quick browse for 'org-agenda-show-future-repeats'. I then
> did a search of the whole file and it isn't mentioned at all!

The manual cannot possibly (and doesn't) contain a reference to every
variable.

> I was hoping to see something which showed how to use it, as currently I
> have each and every repeat showing for each and every day of my 31-day
> agenda. 

You can know how to use it by looking at its docstring. I copy it here
for reference:

   Non-nil shows repeated entries in the future part of the agenda.
   When set to the symbol ‘next’ only the first future repeat is shown.

> If we have changes, especially major ones like this, could they not be
> mentioned in the org.pdf with perhaps a new chapter titled 'Changes' and
> then giving details of how to use the new commands, please?

The variable was introduced in <http://orgmode.org/Changes.html>


Regards,

-- 
Nicolas Goaziou

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

* Re: BUG - org-agenda-show-future-repeats not mentioned in org.pdf
  2017-09-09 16:19 ` Nicolas Goaziou
@ 2017-09-10 10:54   ` Sharon Kimble
  2017-09-10 11:45     ` Nicolas Goaziou
  0 siblings, 1 reply; 4+ messages in thread
From: Sharon Kimble @ 2017-09-10 10:54 UTC (permalink / raw)
  To: Nicolas Goaziou; +Cc: Org Mode List

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

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Hello,
>
> Sharon Kimble <boudiccas@skimble.plus.com> writes:
>
>> Seeing this new variable I've been trying to set it up to stop all the
>> future displays of each and every task being displayed in my 31 days
>> agenda.
>>
>> I've updated my git/org-mode and then built the new 'org.pdf', opened it
>> and then had a quick browse for 'org-agenda-show-future-repeats'. I then
>> did a search of the whole file and it isn't mentioned at all!
>
> The manual cannot possibly (and doesn't) contain a reference to every
> variable.
>
>> I was hoping to see something which showed how to use it, as currently I
>> have each and every repeat showing for each and every day of my 31-day
>> agenda. 
>
> You can know how to use it by looking at its docstring. I copy it here
> for reference:
>
>    Non-nil shows repeated entries in the future part of the agenda.
>    When set to the symbol ‘next’ only the first future repeat is
>    shown.

Thanks for replying.

You are assuming that everyone knows what a 'docstring' is, and how to
get it or find out about it. Unfortunately, I don't fit into that
category, so when I saw on "http://orgmode.org/Changes.html" 'See
docstring for details.' I was, and still am, completely flummoxed by it,
which is why I looked for it in an updated 'org.pdf'.

Thanks
Sharon.

>
>> If we have changes, especially major ones like this, could they not be
>> mentioned in the org.pdf with perhaps a new chapter titled 'Changes' and
>> then giving details of how to use the new commands, please?
>
> The variable was introduced in <http://orgmode.org/Changes.html>
>
>
> Regards,

-- 
A taste of linux = http://www.sharons.org.uk
TGmeds = http://www.tgmeds.org.uk
DrugFacts = https://www.drugfacts.org.uk  
Debian 9.0, fluxbox 1.3.5-2, emacs 25.1.1, org-mode 9.1

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

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

* Re: BUG - org-agenda-show-future-repeats not mentioned in org.pdf
  2017-09-10 10:54   ` Sharon Kimble
@ 2017-09-10 11:45     ` Nicolas Goaziou
  0 siblings, 0 replies; 4+ messages in thread
From: Nicolas Goaziou @ 2017-09-10 11:45 UTC (permalink / raw)
  To: Sharon Kimble; +Cc: Org Mode List

Sharon Kimble <boudiccas@skimble.plus.com> writes:

> You are assuming that everyone knows what a 'docstring' is, and how to
> get it or find out about it. Unfortunately, I don't fit into that
> category, so when I saw on "http://orgmode.org/Changes.html" 'See
> docstring for details.' I was, and still am, completely flummoxed by it,
> which is why I looked for it in an updated 'org.pdf'.

Emacs has an extensive help system. For example <F1> <F1> displays
a list of all help you can get. In particular, in this menu, you can see

  v VARIABLE  Display the given variable's documentation and value.

So if you hit `v', you can select `org-agenda-show-future-repeats' and
read its documentation string, or "docstring".

A shortcut for this is

  <F1> v org-agenda-show-future-repeats RET

Another way to look at it is to use the Customization system Emacs
offers. To get there, you can use

 M-x customize-group RET org RET

You can then browse variables by category, or directly search for the
one you're looking for in the search bar at the top of the buffer.

HTH.

Regards,

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

end of thread, other threads:[~2017-09-10 11:45 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-09-09  9:05 BUG - org-agenda-show-future-repeats not mentioned in org.pdf Sharon Kimble
2017-09-09 16:19 ` Nicolas Goaziou
2017-09-10 10:54   ` Sharon Kimble
2017-09-10 11:45     ` Nicolas Goaziou

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).