Re: [NTG-context] Using \overloaded

2021-01-24 Thread Hans Hagen

On 1/24/2021 10:16 PM, Rik Kabel wrote:

I can find no information on \aliased and the push/pop for overloademode 
and such, so will leave documenting that in the wiki to somebody with a 
few more clues.
it will be (and often is) in documentation and manuals in the 
distribution and in articles in user group journals and so


but anyway it's kind of new and i still need to flag all visible (low 
level) macros and variables (still some 700 to go)


the same is also done for metafun (mostly done but also some to go)

it roughly works as follows:

- primitives are marked as 'primitive' (already by the engine)
- we mark all registers we allocate as 'permanent'
- most constants are marked as 'immutable'
- if we don't care (or can't) we mark something as 'mutable'
- user defined instances are 'frozen' (can be \overloaded)
- \aliased just means: take the properties (applies to \let cs)
- \enforced (in the body of a macro) does just that

the last one is special because it gets internalized in ini mode (when 
the format is made)


there are (and might be some more) flags (like \noaligned)

the other large effort is removing some indirectness (using the extended 
lightweight macro argument parsing features) (mostly done, but it can 
introduce issues due to the rather large amount of tiny adptions but 
luckily these are reported here by users)


anyway, what happens after that depends on \overloadmode (th ehigher the 
more strict, odd a warning, even an error)


it is not (and can never be) complete in terms of protection (too many 
macro definitions, also runtime) but good enough for what i have in 
mind: help users to keep their run working by not redefining essential 
macros


Hans

-
  Hans Hagen | PRAGMA ADE
  Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
   tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl
-
___
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://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___


Re: [NTG-context] Using \overloaded

2021-01-24 Thread Jairo A. del Rio
Hi, Rik. If it helps, flags are explained in lowlevel-security manual:

https://www.pragma-ade.com/general/manuals/lowlevel-security.pdf

Jairo :)

El dom, 24 de ene. de 2021 a la(s) 16:16, Rik Kabel (
cont...@rik.users.panix.com) escribió:

> On 1/24/2021 04:33, Wolfgang Schuster wrote:
> > Rik Kabel schrieb am 24.01.2021 um 05:13:
> >> Hans and all,
> >>
> >> Preparing my standard environments for future strict enforcement of
> >> overloading prevention, I have run into one issue.
> >>
> >> I had been using the following construction to change the formatting
> >> of URLs:
> >>
> >> \let\OrigHyphenatedurl\hyphenatedurl
> >> \starttexdefinition hyphenatedurl #URL
> >>\begingroup
> >>  \URLfont\OrigHyphenatedurl{#URL}
> >>\endgroup
> >> \stoptexdefinition
> >
> >
> > You can use a hook to change the font for \hyphenatedurl.
> >
> > \starttext
> >
> > \hyphenatedurl{https://wiki.contextgarden.net/Main_Page}
> >
> > \appendtoks
> >   \it
> > \to \everyhyphenatedurl
> >
> > \hyphenatedurl{https://wiki.contextgarden.net/Main_Page}
> >
> > \stoptext
> >
> >
> >> This results in the following warning about overloading \hyphenatedurl:
> >>
> >> csname overload > warning, protection level 3, control sequence
> >> 'hyphenatedurl', properties 'permanent protected', file
> >> 'env_layout.mkvi', line 1
> >>
> >> I have tried adding \overloaded to indicate the intentional
> >> overloading, but \overloaded cannot be used with \starttexdefinition,
> >> so I rewrote it as:
> >>
> >> \let\OrigHyphenatedurl\hyphenatedurl
> >> \overloaded\define[1]\hyphenatedurl{%
> >>\begingroup%
> >>  \URLfont\OrigHyphenatedurl{#1}%
> >>\endgroup}%
> >>
> >> but that (and also with \overloaded\def\hyphenatedurl#1...) gives the
> >> same (except for the line number) warning:
> >>
> >> csname overload > warning, protection level 3, control sequence
> >> 'hyphenatedurl', properties 'permanent protected', file
> >> 'env_layout.mkvi', line 822
> >>
> >> So, what is the proper way to indicate intentional overloading? Or
> >> should this redefinition be done in another way?
> >
> >
> > The best solution is *to not* overload commands because there are either
> > alternative ways to achieve the desired result or other commands which
> > can be used.
> >
> >
> > \overloadmode=4
> >
> > \starttext
> >
> > \permanent\def\mycommand#1{[#1]}
> >
> > \mycommand{Old definition}
> >
> > \pushoverloadmode
> >
> > \aliased\let\originalmycommand\mycommand
> >
> > \permanent\def\mycommand#1%
> >   {{\it\originalmycommand{#1}}}
> >
> > \popoverloadmode
> >
> > \mycommand{New definition}
> >
> > \stoptext
> >
> >
> > Wolfgang
>
> Thank you, Wolfgang (and Hans),
>
> The hook is perfect for this. I had avoided that construction for a long
> time thinking that it is too low-level, but looking at it again it seems
> to be the right thing here.
>
> I can find no information on \aliased and the push/pop for overloademode
> and such, so will leave documenting that in the wiki to somebody with a
> few more clues.
>
> --
> Rik
>
>
> ___
> 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://context.aanhet.net
> archive  : https://bitbucket.org/phg/context-mirror/commits/
> wiki : http://contextgarden.net
>
> ___
>
___
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://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___


Re: [NTG-context] Using \overloaded

2021-01-24 Thread Rik Kabel

On 1/24/2021 04:33, Wolfgang Schuster wrote:

Rik Kabel schrieb am 24.01.2021 um 05:13:

Hans and all,

Preparing my standard environments for future strict enforcement of 
overloading prevention, I have run into one issue.


I had been using the following construction to change the formatting 
of URLs:


    \let\OrigHyphenatedurl\hyphenatedurl
    \starttexdefinition hyphenatedurl #URL
   \begingroup
     \URLfont\OrigHyphenatedurl{#URL}
   \endgroup
    \stoptexdefinition



You can use a hook to change the font for \hyphenatedurl.

\starttext

\hyphenatedurl{https://wiki.contextgarden.net/Main_Page}

\appendtoks
  \it
\to \everyhyphenatedurl

\hyphenatedurl{https://wiki.contextgarden.net/Main_Page}

\stoptext



This results in the following warning about overloading \hyphenatedurl:

    csname overload > warning, protection level 3, control sequence
    'hyphenatedurl', properties 'permanent protected', file
    'env_layout.mkvi', line 1

I have tried adding \overloaded to indicate the intentional 
overloading, but \overloaded cannot be used with \starttexdefinition, 
so I rewrote it as:


    \let\OrigHyphenatedurl\hyphenatedurl
    \overloaded\define[1]\hyphenatedurl{%
   \begingroup%
     \URLfont\OrigHyphenatedurl{#1}%
   \endgroup}%

but that (and also with \overloaded\def\hyphenatedurl#1...) gives the 
same (except for the line number) warning:


    csname overload > warning, protection level 3, control sequence
    'hyphenatedurl', properties 'permanent protected', file
    'env_layout.mkvi', line 822

So, what is the proper way to indicate intentional overloading? Or 
should this redefinition be done in another way?



The best solution is *to not* overload commands because there are either
alternative ways to achieve the desired result or other commands which
can be used.


\overloadmode=4

\starttext

\permanent\def\mycommand#1{[#1]}

\mycommand{Old definition}

\pushoverloadmode

\aliased\let\originalmycommand\mycommand

\permanent\def\mycommand#1%
  {{\it\originalmycommand{#1}}}

\popoverloadmode

\mycommand{New definition}

\stoptext


Wolfgang


Thank you, Wolfgang (and Hans),

The hook is perfect for this. I had avoided that construction for a long 
time thinking that it is too low-level, but looking at it again it seems 
to be the right thing here.


I can find no information on \aliased and the push/pop for overloademode 
and such, so will leave documenting that in the wiki to somebody with a 
few more clues.


--
Rik

___
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://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___


Re: [NTG-context] Using \overloaded

2021-01-24 Thread Hans Hagen

On 1/24/2021 5:13 AM, Rik Kabel wrote:

Hans and all,

Preparing my standard environments for future strict enforcement of 
overloading prevention, I have run into one issue.


I had been using the following construction to change the formatting of 
URLs:


\let\OrigHyphenatedurl\hyphenatedurl
\starttexdefinition hyphenatedurl #URL
   \begingroup
     \URLfont\OrigHyphenatedurl{#URL}
   \endgroup
\stoptexdefinition

This results in the following warning about overloading \hyphenatedurl:

csname overload > warning, protection level 3, control sequence
'hyphenatedurl', properties 'permanent protected', file
'env_layout.mkvi', line 1

I have tried adding \overloaded to indicate the intentional overloading, 
but \overloaded cannot be used with \starttexdefinition, so I rewrote it as:


\let\OrigHyphenatedurl\hyphenatedurl
\overloaded\define[1]\hyphenatedurl{%
   \begingroup%
     \URLfont\OrigHyphenatedurl{#1}%
   \endgroup}%

but that (and also with \overloaded\def\hyphenatedurl#1...) gives the 
same (except for the line number) warning:


csname overload > warning, protection level 3, control sequence
'hyphenatedurl', properties 'permanent protected', file
'env_layout.mkvi', line 822

So, what is the proper way to indicate intentional overloading? Or 
should this redefinition be done in another way?


\pushoverloadmode
   ...
\popoverloadmode

(Also, it is interesting that the line number in the first warning 
message does not point to the actual line.)
that has ot do with whne an error is encountered not where it originates 
from


Hans

-
  Hans Hagen | PRAGMA ADE
  Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
   tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl
-
___
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://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___


Re: [NTG-context] Using \overloaded

2021-01-24 Thread Wolfgang Schuster

Rik Kabel schrieb am 24.01.2021 um 05:13:

Hans and all,

Preparing my standard environments for future strict enforcement of 
overloading prevention, I have run into one issue.


I had been using the following construction to change the formatting of 
URLs:


\let\OrigHyphenatedurl\hyphenatedurl
\starttexdefinition hyphenatedurl #URL
   \begingroup
     \URLfont\OrigHyphenatedurl{#URL}
   \endgroup
\stoptexdefinition



You can use a hook to change the font for \hyphenatedurl.

\starttext

\hyphenatedurl{https://wiki.contextgarden.net/Main_Page}

\appendtoks
  \it
\to \everyhyphenatedurl

\hyphenatedurl{https://wiki.contextgarden.net/Main_Page}

\stoptext



This results in the following warning about overloading \hyphenatedurl:

csname overload > warning, protection level 3, control sequence
'hyphenatedurl', properties 'permanent protected', file
'env_layout.mkvi', line 1

I have tried adding \overloaded to indicate the intentional overloading, 
but \overloaded cannot be used with \starttexdefinition, so I rewrote it as:


\let\OrigHyphenatedurl\hyphenatedurl
\overloaded\define[1]\hyphenatedurl{%
   \begingroup%
     \URLfont\OrigHyphenatedurl{#1}%
   \endgroup}%

but that (and also with \overloaded\def\hyphenatedurl#1...) gives the 
same (except for the line number) warning:


csname overload > warning, protection level 3, control sequence
'hyphenatedurl', properties 'permanent protected', file
'env_layout.mkvi', line 822

So, what is the proper way to indicate intentional overloading? Or 
should this redefinition be done in another way?



The best solution is *to not* overload commands because there are either
alternative ways to achieve the desired result or other commands which
can be used.


\overloadmode=4

\starttext

\permanent\def\mycommand#1{[#1]}

\mycommand{Old definition}

\pushoverloadmode

\aliased\let\originalmycommand\mycommand

\permanent\def\mycommand#1%
  {{\it\originalmycommand{#1}}}

\popoverloadmode

\mycommand{New definition}

\stoptext


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://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___


[NTG-context] Using \overloaded

2021-01-23 Thread Rik Kabel

Hans and all,

Preparing my standard environments for future strict enforcement of 
overloading prevention, I have run into one issue.


I had been using the following construction to change the formatting of 
URLs:


   \let\OrigHyphenatedurl\hyphenatedurl
   \starttexdefinition hyphenatedurl #URL
  \begingroup
    \URLfont\OrigHyphenatedurl{#URL}
  \endgroup
   \stoptexdefinition

This results in the following warning about overloading \hyphenatedurl:

   csname overload > warning, protection level 3, control sequence
   'hyphenatedurl', properties 'permanent protected', file
   'env_layout.mkvi', line 1

I have tried adding \overloaded to indicate the intentional overloading, 
but \overloaded cannot be used with \starttexdefinition, so I rewrote it as:


   \let\OrigHyphenatedurl\hyphenatedurl
   \overloaded\define[1]\hyphenatedurl{%
  \begingroup%
    \URLfont\OrigHyphenatedurl{#1}%
  \endgroup}%

but that (and also with \overloaded\def\hyphenatedurl#1...) gives the 
same (except for the line number) warning:


   csname overload > warning, protection level 3, control sequence
   'hyphenatedurl', properties 'permanent protected', file
   'env_layout.mkvi', line 822

So, what is the proper way to indicate intentional overloading? Or 
should this redefinition be done in another way?


(Also, it is interesting that the line number in the first warning 
message does not point to the actual line.)


--
Rik

___
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://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___