Re: [isabelle-dev] Remaining uses of {* ... *} quotation?

2018-11-09 Thread Gerwin.Klein
> On 09.11.2018, at 22:34, Makarius  wrote:
> 
> On 09/11/2018 00:08, gerwin.kl...@data61.csiro.au wrote:
>> We probably still have a few occurrences of these, but no problem
>> phasing them out.
> 
> In principle it is just a matter of applying "isabelle update_cartouches
> -t", but it might require some coordination, especially on AFP.
> 
> E.g. one could set a date for the "big sweep" and make one big
> changeset, or one could gradually update entries in an erratic manner.
> 
> You can probably say better if there are problems to be expected between
> the "stable" and "devel" versions of AFP.

I don’t expect too much trouble from this one. It might make sense to try out 
how the conversion goes a few entries first, and then, if that is satisfactory, 
do a big change set for the rest. 

Cheers,
Gerwin
___
isabelle-dev mailing list
isabelle-...@in.tum.de
https://mailmanbroy.informatik.tu-muenchen.de/mailman/listinfo/isabelle-dev


Re: [isabelle-dev] Remaining uses of {* ... *} quotation?

2018-11-09 Thread Makarius
On 08/11/2018 21:36, Lawrence Paulson wrote:
>> On 8 Nov 2018, at 20:32, Makarius  wrote:
>>
>> In particular, what are the remaining uses of {* ... *}?
> 
> I didn’t even know that existed.

It was used a lot with the 'section' and 'text' commands until recently.
That was actually its main motivation approx. 20 years ago: to delimit
LaTeX sources reliably.

Now the occurrence of {* ... *} in some existing sources makes them look
very old-fashioned, but "isabelle update_cartouches -t" does a thorough
job automatically.


> But I use (*...*) to enclose arbitrary text or comment material out.

Outer comment syntax will remain unchanged: its main purpose is to
comment-out material temporarily, or to write meta-comments (like % in
LaTeX).

Proper document text would normally appear within cartouches and marked
by 'text' or \.


Makarius

___
isabelle-dev mailing list
isabelle-...@in.tum.de
https://mailmanbroy.informatik.tu-muenchen.de/mailman/listinfo/isabelle-dev


Re: [isabelle-dev] Remaining uses of {* ... *} quotation?

2018-11-09 Thread Makarius
On 09/11/2018 00:03, Peter Lammich wrote:
> I sometimes see {* *} in old theory files, and find it funny to be
> reminded that this was standard only 5 years ago ... from my side there
> are no uses of this quotation remaining that I'd know of

Indeed. Do you want to apply "isabelle update_cartouches" yourself on
various AFP entries, e.g. the Automatic_Refinement stack?


> However, (* *) is still very important for informally andquickly
> commenting things out, also in inner syntax!

That is only a historic footnote. It was actually very confusing to have
the same notation (* ... *) in two different meanings:

  * outer syntax: material that is not part of the formal document, but
treated like white space; exception: slightly odd meta-comments (*<*)
... (*>*)

  * inner syntax: material that is not considered part of the term
language, but shown in the document source in the text style of the term
language

At some point there will more Prover IDE support to add/remove the
various formal comments (with control symbols and cartouches) that have
emerged recently. But the old inner syntax is not coming back.


Makarius
___
isabelle-dev mailing list
isabelle-...@in.tum.de
https://mailmanbroy.informatik.tu-muenchen.de/mailman/listinfo/isabelle-dev


Re: [isabelle-dev] Remaining uses of {* ... *} quotation?

2018-11-09 Thread Makarius
On 09/11/2018 00:08, gerwin.kl...@data61.csiro.au wrote:
> We probably still have a few occurrences of these, but no problem
> phasing them out.

In principle it is just a matter of applying "isabelle update_cartouches
-t", but it might require some coordination, especially on AFP.

E.g. one could set a date for the "big sweep" and make one big
changeset, or one could gradually update entries in an erratic manner.

You can probably say better if there are problems to be expected between
the "stable" and "devel" versions of AFP.


Makarius

___
isabelle-dev mailing list
isabelle-...@in.tum.de
https://mailmanbroy.informatik.tu-muenchen.de/mailman/listinfo/isabelle-dev


Re: [isabelle-dev] Remaining uses of {* ... *} quotation?

2018-11-09 Thread Makarius
On 08/11/2018 21:32, Makarius wrote:
> Over the decades we have accumulated funny quotation forms in Isabelle
> syntax that are often hard to explain to new users (also to old users).

I don't have a full overview of all the fine points yet, but the general
idea is like this:

  * cartouches are the main mechanism to embed/nest languages, e.g.
outer syntax -> document source -> inner syntax -> formal comment ->
antiquotation -> ...

  * retain " ... " as a way to quote names and other small bits of text;
its main use to embed inner syntax might eventually be superseded by
cartouches (which some users already do routinely)

  * keep the status-quo of (* ... *) as outer comments (source text that
is not part of the document)


The following can be probably phased out right now:

  * verbatim quotations {* ... *}

  * alt_string `...`

Both become cartouches; this is done by "isabelle update_cartouches"
already.


Rather soon there should be more advanced maintenance tools based on
semantic PIDE markup. E.g. it would allow to replace deeply nested
quotations reliably thanks to formal markup, say as a type/term within
ML. It would also allow to replace ":" by "\" systematically, when
that is formal notation of the term language.


Makarius
___
isabelle-dev mailing list
isabelle-...@in.tum.de
https://mailmanbroy.informatik.tu-muenchen.de/mailman/listinfo/isabelle-dev