[gentoo-doc-cvs] cvs commit: pda-guide.xml - gentoo-doc-cvs

From:	Sven Vermeulen <swift@××××××××××××.org>
To:	gentoo-doc-cvs@l.g.o
Subject:	[gentoo-doc-cvs] cvs commit: pda-guide.xml
Date:	Sun, 07 Oct 2007 12:43:23
Message-Id:	`E1IeVKK-00087K-5f@stork.gentoo.org`

1

swift       07/10/07 12:33:44

2

3

  Modified:             pda-guide.xml

4

  Log:

5

  Small reorg as synce is not the only way to do things (for instance, non Microsoft OS PDAs)

6

7

Revision  Changes    Path

8

1.3                  xml/htdocs/doc/en/draft/pda-guide.xml

9

10

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml?rev=1.3&view=markup

11

plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml?rev=1.3&content-type=text/plain

12

diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml?r1=1.2&r2=1.3

13

14

Index: pda-guide.xml

15

===================================================================

16

RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml,v

17

retrieving revision 1.2

18

retrieving revision 1.3

19

diff -u -r1.2 -r1.3

20

--- pda-guide.xml	6 Oct 2007 17:01:54 -0000	1.2

21

+++ pda-guide.xml	7 Oct 2007 12:33:44 -0000	1.3

22

@@ -1,6 +1,6 @@

23

 <?xml version='1.0' encoding="UTF-8"?>

24

 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

25

-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml,v 1.2 2007/10/06 17:01:54 swift Exp $ -->

26

+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml,v 1.3 2007/10/07 12:33:44 swift Exp $ -->

27

28

 <guide link="/doc/en/draft/pda-guide.xml" lang="en">

29

 <title>Gentoo PDA Guide</title>

30

@@ -142,7 +142,7 @@

31

 </chapter>

32

33

 <chapter>

34

-<title>Setting Up SynCE</title>

35

+<title>Using SynCE</title>

36

 <section>

37

 <title>Introduction</title>

38

 <body>

39

@@ -182,7 +182,8 @@

40

 </pre>

41

42

<p>

43

-Then, install the <c>app-pda/synce</c> package to obtain the necessary tools.

44

+Then, install the <c>app-pda/synce</c> and <c>net-dialup/ppp</c> packages to

45

+obtain the necessary tools.

46

 </p>

47

48

 </body>

49

@@ -203,6 +204,18 @@

50

 </pre>

51

52

<p>

53

+This step only has to be performed once: it stored the necessary PPP-related

54

+information inside <path>/etc/ppp/peers/synce-device</path> which is read by PPP

55

+when it is called by <c>synce-serial-start</c>.

56

+</p>

57

+

58

+</body>

59

+</section>

60

+<section>

61

+<title>Accessing The Device</title>

62

+<body>

63

+

64

+<p>

65

 Now, log on as the user who will be using the PDA and run the <c>vdccm</c>

66

 command. This tool is the connection manager for SynCE through which programs

67

 connect to the device.

68

@@ -223,7 +236,7 @@

69

 </pre>

70

71

<p>

72

-TOD In some cases, the first attempts fail but this isn't shown immediately. You

73

+In some cases, the first attempts fail but this isn't shown immediately. You

74

 can rerun the command a few times until the command replies that a serial

75

 connection is already started. To verify that the connection is done, check if a

76

 ppp interface (like ppp0) is created and has an IP address attached to it.

77

@@ -235,10 +248,6 @@

78

79

 </body>

80

 </section>

81

-</chapter>

82

-

83

-<chapter>

84

-<title>Working With Your PDA</title>

85

 <section>

86

 <title>File Navigation and Manipulation</title>

87

 <body>

88

@@ -253,25 +262,29 @@

89

 </p>

90

91

<p>

92

-TODO examples of file navigation and copying

93

-</p>

94

-

95

-</body>

96

-</section>

97

-<section>

98

-<title>TODO Tools with SynCE support</title>

99

-<body>

100

-

101

-<p>

102

-TODO

103

-</p>

104

+Beware though, the behavior of the tools is not all that intuïtive. For

105

+instance, the <c>pls</c> tool shows the contents of the <path>My

106

+Documents</path> directory whereas the <c>pcp</c> tool starts from the <path>My

107

+Device</path> location. As an example, we'll upload a file to the <path>My

108

+Documents</path> folder:

109

+</p>

110

+

111

+<pre caption="Uploading a file">

112

+~$ <i>pls</i>

113

+Directory               Tue 01 Jan 2002 01:00:00 PM CET  Business/

114

+Directory               Tue 01 Jan 2002 01:00:00 PM CET  Personal/

115

+Directory               Tue 01 Jan 2002 01:00:00 PM CET  Templates/

116

+~$ <i>pcp music.mp3 :"My Documents/music.mp3"</i>

117

+File copy of 3852416 bytes took 0 minutes and 38 seconds, that's 101379 bytes/s.

118

+~$ <i>pls</i>

119

+Archive        3852416  Wed 02 Jan 2002 07:05:06 PM CET  music.mp3

120

+Directory               Tue 01 Jan 2002 01:00:00 PM CET  Business/

121

+Directory               Tue 01 Jan 2002 01:00:00 PM CET  Personal/

122

+Directory               Tue 01 Jan 2002 01:00:00 PM CET  Templates/

123

+</pre>

124

125

 </body>

126

 </section>

127

-</chapter>

128

-

129

-<chapter>

130

-<title>SynCE Integration in KDE</title>

131

 <section>

132

 <title>SynCE for KDE Project</title>

133

 <body>

134

@@ -283,11 +296,6 @@

135

 can control your PDA from within KDE.

136

 </p>

137

138

-</body>

139

-</section>

140

-<section>

141

-<title>Using Raki</title>

142

-<body>

143

144

<p>

145

 The <c>raki</c> tool is SynCE's PocketPC management tool for KDE. The first time

146

@@ -299,12 +307,20 @@

147

148

 </body>

149

 </section>

150

+</chapter>

151

+

152

+<chapter>

153

+<title>MultiSync</title>

154

 <section>

155

-<title>TODO Different sync plugin</title>

156

+<title>Introduction</title>

157

 <body>

158

159

<p>

160

-TODO

161

+The <uri link="http://multisync.sourceforge.net/news.php">MultiSync</uri>

162

+project provides plugins for various Gnome and Gnome related tools, including

163

+Evolution, to synchronise data with external devices, including PDAs. MultiSync

164

+uses SynCE to communicate with Windows CE/Mobile devices although it also

165

+supports PDAs that run non-Windows operating systems.

166

 </p>

167

168

 </body>

--

173

gentoo-doc-cvs@g.o mailing list

1	swift 07/10/07 12:33:44
2
3	Modified: pda-guide.xml
4	Log:
5	Small reorg as synce is not the only way to do things (for instance, non Microsoft OS PDAs)
6
7	Revision Changes Path
8	1.3 xml/htdocs/doc/en/draft/pda-guide.xml
9
10	file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml?rev=1.3&view=markup
11	plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml?rev=1.3&content-type=text/plain
12	diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml?r1=1.2&r2=1.3
13
14	Index: pda-guide.xml
15	===================================================================
16	RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml,v
17	retrieving revision 1.2
18	retrieving revision 1.3
19	diff -u -r1.2 -r1.3
20	--- pda-guide.xml 6 Oct 2007 17:01:54 -0000 1.2
21	+++ pda-guide.xml 7 Oct 2007 12:33:44 -0000 1.3
22	@@ -1,6 +1,6 @@
23	<?xml version='1.0' encoding="UTF-8"?>
24	<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25	-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml,v 1.2 2007/10/06 17:01:54 swift Exp $ -->
26	+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/pda-guide.xml,v 1.3 2007/10/07 12:33:44 swift Exp $ -->
27
28	<guide link="/doc/en/draft/pda-guide.xml" lang="en">
29	<title>Gentoo PDA Guide</title>
30	@@ -142,7 +142,7 @@
31	</chapter>
32
33	<chapter>
34	-<title>Setting Up SynCE</title>
35	+<title>Using SynCE</title>
36	<section>
37	<title>Introduction</title>
38	<body>
39	@@ -182,7 +182,8 @@
40	</pre>
41
42	<p>
43	-Then, install the <c>app-pda/synce</c> package to obtain the necessary tools.
44	+Then, install the <c>app-pda/synce</c> and <c>net-dialup/ppp</c> packages to
45	+obtain the necessary tools.
46	</p>
47
48	</body>
49	@@ -203,6 +204,18 @@
50	</pre>
51
52	<p>
53	+This step only has to be performed once: it stored the necessary PPP-related
54	+information inside <path>/etc/ppp/peers/synce-device</path> which is read by PPP
55	+when it is called by <c>synce-serial-start</c>.
56	+</p>
57	+
58	+</body>
59	+</section>
60	+<section>
61	+<title>Accessing The Device</title>
62	+<body>
63	+
64	+<p>
65	Now, log on as the user who will be using the PDA and run the <c>vdccm</c>
66	command. This tool is the connection manager for SynCE through which programs
67	connect to the device.
68	@@ -223,7 +236,7 @@
69	</pre>
70
71	<p>
72	-TOD In some cases, the first attempts fail but this isn't shown immediately. You
73	+In some cases, the first attempts fail but this isn't shown immediately. You
74	can rerun the command a few times until the command replies that a serial
75	connection is already started. To verify that the connection is done, check if a
76	ppp interface (like ppp0) is created and has an IP address attached to it.
77	@@ -235,10 +248,6 @@
78
79	</body>
80	</section>
81	-</chapter>
82	-
83	-<chapter>
84	-<title>Working With Your PDA</title>
85	<section>
86	<title>File Navigation and Manipulation</title>
87	<body>
88	@@ -253,25 +262,29 @@
89	</p>
90
91	<p>
92	-TODO examples of file navigation and copying
93	-</p>
94	-
95	-</body>
96	-</section>
97	-<section>
98	-<title>TODO Tools with SynCE support</title>
99	-<body>
100	-
101	-<p>
102	-TODO
103	-</p>
104	+Beware though, the behavior of the tools is not all that intuïtive. For
105	+instance, the <c>pls</c> tool shows the contents of the <path>My
106	+Documents</path> directory whereas the <c>pcp</c> tool starts from the <path>My
107	+Device</path> location. As an example, we'll upload a file to the <path>My
108	+Documents</path> folder:
109	+</p>
110	+
111	+<pre caption="Uploading a file">
112	+~$ <i>pls</i>
113	+Directory Tue 01 Jan 2002 01:00:00 PM CET Business/
114	+Directory Tue 01 Jan 2002 01:00:00 PM CET Personal/
115	+Directory Tue 01 Jan 2002 01:00:00 PM CET Templates/
116	+~$ <i>pcp music.mp3 :"My Documents/music.mp3"</i>
117	+File copy of 3852416 bytes took 0 minutes and 38 seconds, that's 101379 bytes/s.
118	+~$ <i>pls</i>
119	+Archive 3852416 Wed 02 Jan 2002 07:05:06 PM CET music.mp3
120	+Directory Tue 01 Jan 2002 01:00:00 PM CET Business/
121	+Directory Tue 01 Jan 2002 01:00:00 PM CET Personal/
122	+Directory Tue 01 Jan 2002 01:00:00 PM CET Templates/
123	+</pre>
124
125	</body>
126	</section>
127	-</chapter>
128	-
129	-<chapter>
130	-<title>SynCE Integration in KDE</title>
131	<section>
132	<title>SynCE for KDE Project</title>
133	<body>
134	@@ -283,11 +296,6 @@
135	can control your PDA from within KDE.
136	</p>
137
138	-</body>
139	-</section>
140	-<section>
141	-<title>Using Raki</title>
142	-<body>
143
144	<p>
145	The <c>raki</c> tool is SynCE's PocketPC management tool for KDE. The first time
146	@@ -299,12 +307,20 @@
147
148	</body>
149	</section>
150	+</chapter>
151	+
152	+<chapter>
153	+<title>MultiSync</title>
154	<section>
155	-<title>TODO Different sync plugin</title>
156	+<title>Introduction</title>
157	<body>
158
159	<p>
160	-TODO
161	+The <uri link="http://multisync.sourceforge.net/news.php">MultiSync</uri>
162	+project provides plugins for various Gnome and Gnome related tools, including
163	+Evolution, to synchronise data with external devices, including PDAs. MultiSync
164	+uses SynCE to communicate with Windows CE/Mobile devices although it also
165	+supports PDAs that run non-Windows operating systems.
166	</p>
167
168	</body>
169
170
171
172	--
173	gentoo-doc-cvs@g.o mailing list

Gentoo Archives: gentoo-doc-cvs