=head1 NAME

Acme::Don't - Das Gegenteil von C<do>

=head1 VERSION

Dieses Dokument beschreibt Version 1.01 von Acme::Don::t,
veröffentlicht am 3. Mai 2002.

=head1 ÜBERBLICK

    use Acme::Don't;

    don't { print "Dieser Text wird " .
                  "nicht ausgegeben werden\n" };    # NO-OP

=head1 BESCHREIBUNG

Das Modul Acme::Don't definiert ein Kommando namens C<don't>,
das das Gegenstück zum Perl-eigenen C<do> darstellt.

Es wird genauso verwendet wie die Funktion C<do BLOCK>,
mit der Ausnahme, dass es, statt den übergebenen Block auszuführen,
das... nunja... nicht tut.

Unabhängig vom Inhalt des Blocks, gibt C<don't> C<undef> zurück.

Auch das hier geht:

    don't {
        # Code
    } while bedingung();

Und ja: In strenger Anlehnung an die Semantik von Perls magischem
C<do...while> wird der C<don't...while>-Block dabei I<in jedem Fall>
vor der Prüfung der Bedingung kein einziges Mal ausgeführt. ;-)

Zu beachten ist, dass der C<don't>-Block syntaktisch korrekten Perl-Code
enthalten muss.
Das ist ein zentraler Punkt:
Die durch Nicht-Ausführung des Codes erzielten Leistungssteigerung
wird erzielt, ohne die Sicherheit, die die Syntax-Prüfung während der
Übersetzung des Scripts bietet, zu opfern.

=head1 EINSCHRÄNKUNGEN

=over

=item *

Das Gegenteil von C<do ZEICHENKETTE> wird (noch) nicht implementiert.
Als provisorische Lösung funktioniert:

    don't {"Dateiname"};

=item *

Das Konstrukt

    don't { don't { ... } }

ist (noch) nicht bedeutungsgleich mit:

    do { ... }

weil das äußere C<don't> die Ausführung des inneren C<don't> verhindert,
bevor das innere C<don't> die Möglichkeit hat zu erkennen, dass es tatsächlich
I<doch> ausgeführt werden sollte.

Das ist freilich eine Frage der Semantik.
C<don't> bedeutet nicht C<tu das Gegenteil...>;
es bedeutet C<tu nichts mit...>.

Anders gesagt:
Nichts gegen nichts tun tut... nichts.

=item * 

Es ist (noch) nicht möglich

    don't { ... } unless bedingung();

als Ersatz für

    do { ... } if bedingung();

einzusetzen.

Auch dies ist eine Frage der Semantik.
C<don't...unless...> bedeutet nicht C<tu das Gegenteil von...falls...>;
es bedeutet C<tu nichts mit...falls nicht...>.

=back

=head1 URHEBER

Damian Conway (damian@conway.org)

=head1 BESCHWERDEN

Luke Palmer sollte I<sehr> viel besser aufpassen, bevor er vorschnell Wünsche
äußert.

=head1 FEHLER

Unwahrscheintlich, denn es tut ja nichts.
Ansonsten sind Fehlerberichte und anderweitige Rückmeldungen sehr willkommen.

=head1 COPYRIGHT

Copyright (c) 2002, Damian Conway. Alle Rechte vorbehalten.
Dieses Modul ist freie Software.
Es darf gemäß den Vorschriften der Perl Artistic License verwendet,
weitergegeben und/oder verändert werden
  (vgl. http://www.perl.com/perl/misc/Artistic.html)