r18208: Mac OS X also doesn't have history_list()
[jelmer/samba4-debian.git] / swat2.txt
1 Abstract:
2 ---------
3 This document attempts to outline the requirements for SWAT 2. In particular, 
4 this is an attempt to bring together some ideas in order to stimulate though
5 about what exactly we want SWAT to do.
6
7
8 Introduction:
9 -------------
10 Swat, as it exists in Samba 3 and before, is not significantly more than an
11 editor for smb.conf. The interface seems targeted at users who are already
12 familiar with smb.conf configuration. 
13
14 For version 4 of the Samba suite, we would like to provide a swat that becomes
15 the definitive tool for configuring Samba. As this is a fairly difficult task,
16 it is imperative that a significant amount of thought is given to both the
17 internal structure and the user interface of Swat.
18
19
20 Current Issues:
21 ---------------
22 - swat completely destroys the current format of smb.conf. Any ordering of
23   parameters, comments, and whitespace formatting will be lost.
24
25 - though the wizard is very useful, it does not provide enough functionality
26   to setup a first time user. (e.g. the workgroup cannot be set in the wizard)
27
28 - in almost all configurations, many of the displayed params should be left
29   empty. (i.e. netbios aliases)
30
31 - installation is not easy for most users
32
33 - nobody uses it
34
35
36 Future Issues:
37 --------------
38 - The number of configuration parameters, as much as we all hate them, are
39   likely to grow. Many will be for small strings or such things. The current
40   SWAT layout will not handle this very well
41
42
43 Wishlist:
44 ---------
45 - a registry editor in swat
46
47 - the advanced / developer options available, but hidden from basic users
48
49 - a more beginner-oriented wizard
50   - I (vance) would like to see a something that asks a few questions, like
51     what do you want to do? (check all that apply)
52     o  share files
53     o  share printers
54     o  be a domain controller
55
56     what kind of network are you on? (choose one)
57     o  home network, no domain, no passwords
58     o  small office network, no domain
59     o  small office network, pre-existing domain
60     o  medium network, pre-existing domain
61     o  large network, pre-existing domain
62
63     what kind of computers are on your network? (check all that apply)
64     o  w31
65     o  W9x
66     o  NT
67     o  w2k
68     o  xp / w2k3
69
70 - a "make copy" function for shares, to allow users to clone existing shares
71   then edit them
72
73 - some smarts for parameters:
74   - a user/group selector for things like valid users, admin users, read list,
75     write list, etc.
76   - an fs navigator for path type things
77