1$OpenBSD: BaseState.pod,v 1.2 2022/12/28 21:30:18 jmc Exp $
2
3=head1 NAME
4
5OpenBSD::BaseState - light-weight IO and system access in pkg_add
6
7=head1 SYNOPSIS
8
9    use OpenBSD::BaseState;
10
11    OpenBSD::BaseState->say("I'm sorry #1, I'm afraid I can't do that", $user);
12    OpenBSD::BaseState->system('make', '-C');
13
14=head1 DESCRIPTION
15
16C<OpenBSD::BaseState> contains utility functions for C<OpenBSD::State> objects,
17as a light-weight framework for perl code that doesn't really need fully
18fledged state objects and all the extra luggage that the object provides.
19
20As such, C<OpenBSD::BaseState> contains the actual code for
21C<fhprint>, C<fhsay> C<print>, C<say>, C<errsay>, C<fatal>, C<f>, C<system>, C<verbose_system>, C<copy_file>, C<unlink>, C<copy>
22
23=over 4
24
25=item $class->can_output
26
27hook to be overridden if need be, for programs that do not want to keep
28writing to the terminal in the background. Returns 1 by default.
29
30=back
31
32=head1 BUGS
33
34User interface needs are not fully fleshed out and C<OpenBSD::State> is
35a work-in-progress.  What's described here should hopefully no longer
36change too much.
37