`evaluation.adoc` is inconsistent with current function evaluation semantics

Aperta
#95 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
45/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Ambito
documentation

Direzione di ricerca

Inizia con content/reference/evaluation.adoc e con la discussione CLJ-1206 collegata nell’issue. Verifica il comportamento previsto di eval per gli oggetti funzione e gli altri oggetti, quindi aggiorna la formulazione per distinguere tra autovalutazione garantita, errori e comportamento non definito. Il lavoro è completato quando la pagina riflette accuratamente la semantica attuale.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

content

evaluation.adoc states that "Any object other than those discussed above will evaluate to itself," without mentioning function objects. In CLJ-1206, it was reported that certain function objects cause errors in eval, when nested in a form (and since that bug was opened, several others have independently run into this problem and posted on the mailing list).

A fix for CLJ-1206 was declined, with the prevailing opinion seeming to be that eval should not be applied to non-data-structure'y things. If that's the case, clojure.org/reference/evaluation should probably be updated to correctly describe the semantics of eval, and which "other objects" are guaranteed to evaluate to themselves, versus error, versus trigger undefined behavior.

Lingua principale
HTML
Stelle
259
Fork
275
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di clojure/clojure-site

Tutte le issue di clojure/clojure-site

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.