Re: Where is the documentation of the letter module

Re: Where is the documentation of the letter module

[Michael Green]

On May 24, 2012, at 3:13 PM, Florian Wobbe wrote:

> is there anyone else who knows where the current correspondence docu resides? I tried again to locate it but to no avail.

I find the manual in these places.

/tex/texmf-modules/doc/context/third/letter

https://bitbucket.org/wolfs/correspondence/downloads


There is some guidance about what's new in these messages:

http://www.ntg.nl/pipermail/ntg-context/2012/064695.html

http://www.ntg.nl/pipermail/ntg-context/2012/065039.html
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Where is the documentation of the letter module

[Florian Wobbe]

>> is there anyone else who knows where the current correspondence docu resides? I tried again to locate it but to no avail.
> 
> There is some guidance about what's new in these messages:
> 
> http://www.ntg.nl/pipermail/ntg-context/2012/064695.html
> 
> http://www.ntg.nl/pipermail/ntg-context/2012/065039.html

Michael, thanks a lot. These were in fact the missing links! With the help of the comments in the thread above and looking into the sources I was able to reproduce most of my old letter template. However, I'm struggling to get the enclosures into an itemized list. This used to work with the old letter module but now fails:

  \startletter[enclosure={A\\B\\C}, ...] --> encl: AcrlfBcrlfC

In http://www.ntg.nl/pipermail/ntg-context/2012/064721.html Wolfgang proposed \startletter[enclosure={list:one,two,three}, ...] to get an itemized list. But this does not seem to be implemented yet. How would I get this right?


Wolfgang, I believe I found a bug that introduces some extra space in the backaddress: "fromname, <extra space>, fromaddress". Here is the fix:

--- a/texmf-modules/tex/context/third/letter/base/s-cor-01.mkvi
+++ b/texmf-modules/tex/context/third/letter/base/s-cor-01.mkvi
@@ -297,7 +297,7 @@
 \defineletterelement[\v!layer][\v!backaddress][\s!default]
   {\def\\{\correspondencelayerparameter\c!separator}%
    \correspondenceparameter\c!fromname
-   \doifsomething{\correspondenceparameter\c!fromaddress}\\
+   \doifsomething{\correspondenceparameter\c!fromaddress}\\%
    \correspondenceparameter\c!fromaddress}
 
 \defineletterelement[\v!layer][\v!backaddress][\v!auto]

Cheers,
Florian
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Where is the documentation of the letter module

[Wolfgang Schuster]

Am 30.05.2012 um 01:30 schrieb Florian Wobbe:

>>> is there anyone else who knows where the current correspondence docu resides? I tried again to locate it but to no avail.
>> 
>> There is some guidance about what's new in these messages:
>> 
>> http://www.ntg.nl/pipermail/ntg-context/2012/064695.html
>> 
>> http://www.ntg.nl/pipermail/ntg-context/2012/065039.html
> 
> Michael, thanks a lot. These were in fact the missing links! With the help of the comments in the thread above and looking into the sources I was able to reproduce most of my old letter template. However, I'm struggling to get the enclosures into an itemized list. This used to work with the old letter module but now fails:
> 
>  \startletter[enclosure={A\\B\\C}, ...] --> encl: AcrlfBcrlfC
> 
> In http://www.ntg.nl/pipermail/ntg-context/2012/064721.html Wolfgang proposed \startletter[enclosure={list:one,two,three}, ...] to get an itemized list. But this does not seem to be implemented yet. How would I get this right?

It does work but you need MkIV:

\usemodule[letter]

\setupletterdescription
  [enclosure]
  [
     location=top,
     leftmargin=1em,
     symbol=bullet,
  ]

\setupletter
  [enclosure={list:One,Two,Three}]

\startletter
\input knuth
\stopletter

> Wolfgang, I believe I found a bug that introduces some extra space in the backaddress: "fromname, <extra space>, fromaddress". Here is the fix:
> 
> […]

Fixed.

Wolfgang
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Where is the documentation of the letter module

[Florian Wobbe]

>>>> [...] I'm struggling to get the enclosures into an itemized list. This used to work with the old letter module but now fails:
>> 
>> \startletter[enclosure={A\\B\\C}, ...] --> encl: AcrlfBcrlfC
>> 
>> In http://www.ntg.nl/pipermail/ntg-context/2012/064721.html Wolfgang proposed \startletter[enclosure={list:one,two,three}, ...] to get an itemized list. But this does not seem to be implemented yet. How would I get this right?
> 
> It does work but you need MkIV:
> 
> \usemodule[letter]
> 
> \setupletterdescription
>  [enclosure]
>  [
>     location=top,
>     leftmargin=1em,
>     symbol=bullet,
>  ]
> 
> \setupletter
>  [enclosure={list:One,Two,Three}]
> 
> \startletter
> \input knuth
> \stopletter

Thanks, Wolfgang, got that working now. But I'd like to change the formatting of the list further from

encl:
 * One
 * Two
 * Three

to

encl: One
      Two
      Three

without symbols. So I tried:

 \setupletterdescription [enclosure] [symbol=bullet]

This did not work so I tried:

 \definesymbol[nosymbol][{}]
 \setupletterdescription [enclosure] [symbol=nosymbol]

But that results in:

encl:<too much space> One
     <too much space> Two
     <too much space> Three

I cannot remove the extra space with:

 \setupletterdescription [enclosure] [symbol=nosymbol,distance=0em]

Note, that this works:

\setupitemize[each][fit][distance=0em]
\startitemize
  \item no extra space before bullet
\stopitemize

--> *no extra space before bullet

However, it does not work with an enumeration once the symbol was removed:

\setupitemize[each][fit][symbol={},distance=0em]
\startitemize
  \item item
\stopitemize

--> <too much space> item

Florian
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Where is the documentation of the letter module

[Wolfgang Schuster]

Am 30.05.2012 um 11:58 schrieb Florian Wobbe:

>>>>> [...] I'm struggling to get the enclosures into an itemized list. This used to work with the old letter module but now fails:
>>> 
>>> \startletter[enclosure={A\\B\\C}, ...] --> encl: AcrlfBcrlfC
>>> 
>>> In http://www.ntg.nl/pipermail/ntg-context/2012/064721.html Wolfgang proposed \startletter[enclosure={list:one,two,three}, ...] to get an itemized list. But this does not seem to be implemented yet. How would I get this right?
>> 
>> It does work but you need MkIV:
>> 
>> \usemodule[letter]
>> 
>> \setupletterdescription
>> [enclosure]
>> [
>>    location=top,
>>    leftmargin=1em,
>>    symbol=bullet,
>> ]
>> 
>> \setupletter
>> [enclosure={list:One,Two,Three}]
>> 
>> \startletter
>> \input knuth
>> \stopletter
> 
> Thanks, Wolfgang, got that working now. But I'd like to change the formatting of the list further from
> 
> encl:
> * One
> * Two
> * Three
> 
> to
> 
> encl: One
>      Two
>      Three
> 
> without symbols. So I tried:
> 
> \setupletterdescription [enclosure] [symbol=bullet]
> 
> This did not work so I tried:
> 
> \definesymbol[nosymbol][{}]
> \setupletterdescription [enclosure] [symbol=nosymbol]

ConTeXt has a empty symbol with the name “none”.

> But that results in:
> 
> encl:<too much space> One
>     <too much space> Two
>     <too much space> Three
> 
> I cannot remove the extra space with:
> 
> \setupletterdescription [enclosure] [symbol=nosymbol,distance=0em]
> 
> Note, that this works:
> 
> \setupitemize[each][fit][distance=0em]
> \startitemize
>  \item no extra space before bullet
> \stopitemize
> 
> --> *no extra space before bullet
> 
> However, it does not work with an enumeration once the symbol was removed:
> 
> \setupitemize[each][fit][symbol={},distance=0em]

\setupitemize[each][symbol=none,width=0pt,distance=0pt]

> \startitemize
>  \item item
> \stopitemize
> 
> --> <too much space> item

I uploaded a new revision which doesn’t insert an extra space when you use “symbol=none”.

Wolfgang
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Where is the documentation of the letter module

[Florian Wobbe]

>>>>>> [...] I'm struggling to get the enclosures into an itemized list. This used to work with the old letter module but now fails:
>>>> 
>>>> \startletter[enclosure={A\\B\\C}, ...] --> encl: AcrlfBcrlfC
>>>> 
>>>> In http://www.ntg.nl/pipermail/ntg-context/2012/064721.html Wolfgang proposed \startletter[enclosure={list:one,two,three}, ...] to get an itemized list. But this does not seem to be implemented yet. How would I get this right?
>>> 
>>> It does work but you need MkIV:
>>> 
>>> \usemodule[letter]
>>> 
>>> \setupletterdescription
>>> [enclosure]
>>> [
>>>   location=top,
>>>   leftmargin=1em,
>>>   symbol=bullet,
>>> ]
>>> 
>>> \setupletter
>>> [enclosure={list:One,Two,Three}]
>>> 
>>> \startletter
>>> \input knuth
>>> \stopletter
>> 
>> Thanks, Wolfgang, got that working now. But I'd like to change the formatting of the list further from
>> 
>> encl:
>> * One
>> * Two
>> * Three
>> 
>> to
>> 
>> encl: One
>>     Two
>>     Three
>> 
>> without symbols. So I tried:
>> 
>> \setupletterdescription [enclosure] [symbol=bullet]
>> 
>> This did not work so I tried:
>> 
>> \definesymbol[nosymbol][{}]
>> \setupletterdescription [enclosure] [symbol=nosymbol]
> 
> ConTeXt has a empty symbol with the name “none”.

Very helpful indeed!

>> But that results in:
>> 
>> encl:<too much space> One
>>    <too much space> Two
>>    <too much space> Three
>> 
>> I cannot remove the extra space with:
>> 
>> \setupletterdescription [enclosure] [symbol=nosymbol,distance=0em]
>> 
>> Note, that this works:
>> 
>> \setupitemize[each][fit][distance=0em]
>> \startitemize
>> \item no extra space before bullet
>> \stopitemize
>> 
>> --> *no extra space before bullet
>> 
>> However, it does not work with an enumeration once the symbol was removed:
>> 
>> \setupitemize[each][fit][symbol={},distance=0em]
> 
> \setupitemize[each][symbol=none,width=0pt,distance=0pt]

Good!

>> \startitemize
>> \item item
>> \stopitemize
>> 
>> --> <too much space> item
> 
> I uploaded a new revision which doesn’t insert an extra space when you use “symbol=none”.

Thanks for this quick enhancement, works now! Just for completeness: How do I change the distance between bullet and item text in your original suggestion? Adding 'width=' here does not change anything:

\setupletterdescription
 [enclosure]
 [
    location=top,
    leftmargin=1em,
    width=5pt,
    symbol=bullet
 ]

Florian
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Where is the documentation of the letter module

[Florian Wobbe]

> Wolfgang:
> 
> I have an old letter that typesets fine with beta 2011.11.29 23:11 but that fails with anything newer than that.
> 
> I get lots of "Undefined control sequence" and \textwidth seems to expand to something without a unit: "Illegal unit of measure (pt inserted)".
> 
> Anyway, I guess there are big changes so I'd like to go through the documentation again. However, [1] seems to be gone now and the pdf in [2] is absent too.
> 
> Cheers,
> Florian
> 
> [1] texmf-context/tex/context/third/letter/base/t-correspondence.tex
> [2] http://dl.contextgarden.net/modules/t-letter/doc/context/third/letter/

Hi,

is there anyone else who knows where the current correspondence docu resides? I tried again to locate it but to no avail. I know there is also [3] but it claims to be from 2010-08-27. I checked the tree of beta 2011.11.29 23:11 once more. There, the documentation is in

  texmf-context/source/context/third/letter/doc/correspondence

But that directory does not exist anymore. Now there seems to be only one file left:

  texmf-context/doc/context/third/letter/README

Cheers,
Florian

[3] http://cdn.bitbucket.org/wolfs/correspondence/downloads/correspondence.pdf

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Where is the documentation of the letter module

[Florian Wobbe]

Wolfgang:

I have an old letter that typesets fine with beta 2011.11.29 23:11 but that fails with anything newer than that.

I get lots of "Undefined control sequence" and \textwidth seems to expand to something without a unit: "Illegal unit of measure (pt inserted)".

Anyway, I guess there are big changes so I'd like to go through the documentation again. However, [1] seems to be gone now and the pdf in [2] is absent too.

Cheers,
Florian

[1] texmf-context/tex/context/third/letter/base/t-correspondence.tex
[2] http://dl.contextgarden.net/modules/t-letter/doc/context/third/letter/
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________