This repository has been archived by the owner on Apr 18, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathGettingStarted.html
360 lines (329 loc) · 31.6 KB
/
GettingStarted.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
<meta charset="utf-8" />
<link rel="shortcut icon" href="sites/saros-project.org/themes/saros/favicon.ico.html" type="image/vnd.microsoft.icon" />
<link rel="shortlink" href="node/59.html" />
<link rel="canonical" href="GettingStarted.html" />
<meta name="Generator" content="Drupal 7 (http://drupal.org)" />
<title>Getting Started with Saros | Saros</title>
<style type="text/css" media="all">
@import url("modules/system/system.base.css");
@import url("modules/system/system.menus.css");
@import url("modules/system/system.messages.css");
@import url("modules/system/system.theme.css");
</style>
<style type="text/css" media="all">
@import url("sites/all/modules/ldap/ldap_user/ldap_user.css");
@import url("modules/book/book.css");
@import url("modules/comment/comment.css");
@import url("modules/field/theme/field.css");
@import url("modules/node/node.css");
@import url("modules/search/search.css");
@import url("sites/all/modules/toc_filter/toc_filter.css");
@import url("modules/user/user.css");
@import url("modules/forum/forum.css");
</style>
<style type="text/css" media="all">
@import url("sites/all/modules/ctools/css/ctools.css");
@import url("sites/all/modules/ldap/ldap_servers/ldap_servers.admin.css");
</style>
<style type="text/css" media="all">
@import url("sites/saros-project.org/themes/touch/style.css");
@import url("sites/saros-project.org/themes/saros/saros_style.css");
</style>
<script type="text/javascript" src="misc/jquery.js%3Fv=1.4.4.html"></script>
<script type="text/javascript" src="misc/jquery.once.js%3Fv=1.2.html"></script>
<script type="text/javascript" src="misc/drupal.js%3Fp9abym.html"></script>
<script type="text/javascript" src="sites/all/modules/toc_filter/toc_filter.js%3Fp9abym.html"></script>
<script type="text/javascript" src="sites/saros-project.org/themes/touch/js/scrolltopcontrol.js%3Fp9abym.html"></script>
<script type="text/javascript">
<!--//--><![CDATA[//><!--
jQuery.extend(Drupal.settings, {"basePath":"\/","pathPrefix":"","ajaxPageState":{"theme":"saros","theme_token":"WBKZ5rOhDYnIDUm7dM9W5kFx6SBmC4JI1cl3ZzscAuM","js":{"misc\/jquery.js":1,"misc\/jquery.once.js":1,"misc\/drupal.js":1,"sites\/all\/modules\/toc_filter\/toc_filter.js":1,"sites\/saros-project.org\/themes\/touch\/js\/scrolltopcontrol.js":1},"css":{"modules\/system\/system.base.css":1,"modules\/system\/system.menus.css":1,"modules\/system\/system.messages.css":1,"modules\/system\/system.theme.css":1,"sites\/all\/modules\/ldap\/ldap_user\/ldap_user.css":1,"modules\/book\/book.css":1,"modules\/comment\/comment.css":1,"modules\/field\/theme\/field.css":1,"modules\/node\/node.css":1,"modules\/search\/search.css":1,"sites\/all\/modules\/toc_filter\/toc_filter.css":1,"modules\/user\/user.css":1,"modules\/forum\/forum.css":1,"sites\/all\/modules\/ctools\/css\/ctools.css":1,"sites\/all\/modules\/ldap\/ldap_servers\/ldap_servers.admin.css":1,"sites\/saros-project.org\/themes\/touch\/style.css":1,"sites\/saros-project.org\/themes\/saros\/saros_style.css":1}},"toc_filter_smooth_scroll_duration":"","urlIsAjaxTrusted":{"\/GettingStarted":true}});
//--><!]]>
</script>
<!--[if lt IE 9]>
<script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
</head>
<body class="html not-front not-logged-in no-sidebars page-node page-node- page-node-59 node-type-page" >
<div id="wrapper" class="clearfix">
<div id="header-top" class="clearfix">
<div id="logo"><!--start logo-->
<a id="site_name_link" href="index.html" title="Home">
<img src="sites/saros-project.org/files/saros-logo-100x100.png" alt="Home" />
</a>
<div id="name_slogan">
<a id="site-name" href="index.html" title="Home" rel="home"><span>Saros</span></a>
<br/>
<a id="site-slogan" id="site-name" href="index.html" title="Home" rel="home"><span>Distributed Party Programming</span></a>
</div><!--end name_slogan-->
<!--div id="site-slogan">Distributed Party Programming</div><!--site slogan-->
</div><!--end logo-->
<!-- / start search box region -->
<div class="search-box">
<div class="region region-search-box">
<div id="block-search-form" class="block block-search">
<div class="content">
<form action="GettingStarted.html" method="post" id="search-block-form" accept-charset="UTF-8"><div><div class="container-inline">
<h2 class="element-invisible">Search form</h2>
<div class="form-item form-type-textfield form-item-search-block-form">
<label class="element-invisible" for="edit-search-block-form--2">Search </label>
<input title="Enter the terms you wish to search for." type="text" id="edit-search-block-form--2" name="search_block_form" value="" size="15" maxlength="128" class="form-text" />
</div>
<div class="form-actions form-wrapper" id="edit-actions"><input type="submit" id="edit-submit" name="op" value="Search" class="form-submit" /></div><input type="hidden" name="form_build_id" value="form-6r16atKeQUe3PT6pe5WiD2yOKHd-fzG6zpNN07taWQg" />
<input type="hidden" name="form_id" value="search_block_form" />
</div>
</div></form> </div>
</div> <!-- /.block -->
</div>
<!-- /.region -->
</div> <!-- / end search box region -->
</div><!--end header-top-->
<div id="header" class="clearfix"><!--start header-->
<div id="main-menu">
<ul class="menu"><li class="first leaf"><a href="home.html" title="Frontpage">Home</a></li>
<li class="expanded"><a href="node/66.html">About Saros</a><ul class="menu"><li class="first leaf"><a href="features.html" title="List of Saros features">Features</a></li>
<li class="leaf"><a href="screenshots.html" title="Get impressions with screenshots">Screenshots</a></li>
<li class="leaf"><a href="host-comic.html">Saros Host Comic</a></li>
<li class="leaf"><a href="what-others-say.html" title="Information about where Saros has been mentioned">What others say</a></li>
<li class="last leaf"><a href="history.html" title="Development history and people involved">History</a></li>
</ul></li>
<li class="expanded active-trail"><a href="setup.html" title="Learn how to use Saros" class="active-trail">Installation & Set-Up</a><ul class="menu"><li class="first expanded"><a href="installation.html" title="Installing Saros in Eclipse">Install Saros</a><ul class="menu"><li class="first last leaf"><a href="setupXMPP.html" title="Setup your own XMPP Server (Advanced Users)">Setup own XMPP Server</a></li>
</ul></li>
<li class="last leaf active-trail"><a href="GettingStarted.html" class="active-trail active">Getting Started with Saros</a></li>
</ul></li>
<li class="expanded"><a href="support_home.html">Support</a><ul class="menu"><li class="first leaf"><a href="mailing-list-chat.html" title="Information on how to reach the Saros team via mailing lists">Mailing Lists</a></li>
<li class="leaf"><a href="troubleshooting.html" title="Known problems when using Saros">Troubleshooting</a></li>
<li class="leaf"><a href="faq.html" title="Frequently asked questions">Saros FAQ</a></li>
<li class="leaf"><a href="compatibility.html">Plugin Compatibility</a></li>
<li class="last leaf"><a href="feedback.html" title="Information about the feature feedback">User Survey & Statistics</a></li>
</ul></li>
<li class="expanded"><a href="getinvolved.html" title="Learn how to develop on Saros">Develop on Saros</a><ul class="menu"><li class="first expanded"><a href="checkout-and-first-steps.html">Check-Out and First Steps</a><ul class="menu"><li class="first expanded"><a href="setup-dev-environment.html">Set up development environment</a><ul class="menu"><li class="first leaf"><a href="dev-environment-reqs.html">Environment Requirements</a></li>
<li class="leaf"><a href="install-subclipse.html">Install Subclipse for building Saros/E</a></li>
<li class="leaf"><a href="install-egit.html">Install EGit</a></li>
<li class="leaf"><a href="our-dev-workflow.html">Our workflow</a></li>
<li class="leaf"><a href="gerrit-login.html">Log in to Gerrit</a></li>
<li class="leaf"><a href="eclipse-setup-git.html">Setting your name and email address for using Gerrit</a></li>
<li class="leaf"><a href="eclipse-setup-ssh.html">Create and configure an SSH key for using Gerrit</a></li>
<li class="leaf"><a href="get-source-code.html">Get Saros source code</a></li>
<li class="leaf"><a href="import-code-style-profiles.html">Import code style profiles</a></li>
<li class="last leaf"><a href="run-saros-as-dev.html">Run your Saros</a></li>
</ul></li>
<li class="last expanded"><a href="make-first-change.html">Making changes to Saros</a><ul class="menu"><li class="first leaf"><a href="node/124.html">Create a new local branch</a></li>
<li class="leaf"><a href="node/125.html">Doing your first change</a></li>
<li class="leaf"><a href="commit-and-push-first-change.html">Commit and push your change</a></li>
<li class="last leaf"><a href="node/127.html">Abandon your change in Gerrit</a></li>
</ul></li>
</ul></li>
<li class="collapsed"><a href="ongoing-work.html">Ongoing Work</a></li>
<li class="expanded"><a href="guidelines.html">Guidelines</a><ul class="menu"><li class="first leaf"><a href="contribution.html">Contribution Rules</a></li>
<li class="collapsed"><a href="coderules.1.html" title="Coding Guidelines and Rules">Coding Conventions</a></li>
<li class="leaf"><a href="usability.html" title="Guidelines to ensure Usability">Usability Guidelines</a></li>
<li class="leaf"><a href="TicketGuidelines.html">Ticket Guidelines</a></li>
<li class="last leaf"><a href="ci-rules.html">Jenkins Rules</a></li>
</ul></li>
<li class="collapsed"><a href="tools.html">Tools</a></li>
<li class="expanded"><a href="processes.html" title="Processes in Saros">Processes</a><ul class="menu"><li class="first leaf"><a href="review.html" title="Information about the review process">Review</a></li>
<li class="leaf"><a href="ReleaseProcess.html" title="Our Release Process">Release</a></li>
<li class="expanded"><a href="testing.html" title="Information about the testing process">Testing</a><ul class="menu"><li class="first last leaf"><a href="jenkins.html">Jenkins and Saros</a></li>
</ul></li>
<li class="leaf"><a href="bugtracker.html" title="Watch the bug tracker">Bug Tracking</a></li>
<li class="last leaf"><a href="documentation.html" title="Information about the documentation process">Documentation</a></li>
</ul></li>
<li class="leaf"><a href="mailingslists.html">Mailinglists</a></li>
<li class="leaf"><a href="https://sourceforge.net/p/dpp/bugs/" title="">Bug Tracker</a></li>
<li class="leaf"><a href="https://sourceforge.net/projects/dpp/" title="Visit Saros at Sourceforge">Saros@Sourceforge</a></li>
<li class="collapsed"><a href="gsoc.1.html">Google Summer of Code</a></li>
<li class="last expanded"><a href="node/129.html">FAQ in daily practice</a><ul class="menu"><li class="first leaf"><a href="node/132.html" title="A change was integrated to master. How can I update my local code?">Update local code to master</a></li>
<li class="leaf"><a href="node/130.html" title="I messed up my local copy of Saros. How can I reset/clean up/revert my changes?">Revert local changes</a></li>
<li class="leaf"><a href="upload-new-patch-set.html" title="Someone discovered an error/failure/typo. How can I upload a new patch set?">Upload a new patch set</a></li>
<li class="leaf"><a href="node/133.html" title="My build failed. What's wrong with my change?">Building in Gerrit failed!</a></li>
<li class="leaf"><a href="gerrit-checkout-patch.html" title="Someone uploaded a change to Gerrit. How can I test this change?">Get & run someones change</a></li>
<li class="leaf"><a href="node/145.html" title="What is a Change? Patch set? Submit?">Change? Patch set? Submit?</a></li>
<li class="leaf"><a href="gerrit-groups-and-permissions.html" title="Which permissions do I have?">Check Gerrit permissions</a></li>
<li class="leaf"><a href="node/142.html" title="How to delete an unwanted local branch in EGit?">Delete local branch</a></li>
<li class="leaf"><a href="node/136.html">Duplicate Location Error</a></li>
<li class="leaf"><a href="gerrit-review.html" title="Someone wants that I review a change. How to review a change?">Review a change</a></li>
<li class="leaf"><a href="node/140.html" title="How to run Saros STF tests locally?">Run STF tests locally</a></li>
<li class="leaf"><a href="node/139.html" title="I ran an STF test (located in test/stf) and get an error! What's wrong?">STF tests fail</a></li>
<li class="leaf"><a href="node/138.html" title="How to set up Saros for running local STF tests?">Set up STF tests</a></li>
<li class="leaf"><a href="node/144.html" title="I want automate my testing process. How to write my own STF tests?">Write STF tests</a></li>
<li class="last leaf"><a href="git-recipes.html">Git use-cases</a></li>
</ul></li>
</ul></li>
<li class="expanded"><a href="techdoc.html" title="Technical Documentation">Technical Documentation</a><ul class="menu"><li class="first leaf"><a href="architectureDocumentation.html">Architecture Documentation</a></li>
<li class="leaf"><a href="specoverview.html">Overview</a></li>
<li class="leaf"><a href="concurrency.html" title="Information about Concurrency">Concurrency</a></li>
<li class="leaf"><a href="eclipsebridge.html">Eclipse Bridge</a></li>
<li class="leaf"><a href="packageFeedback.html" title="Information about the feedback feature">Feedback</a></li>
<li class="leaf"><a href="invitation.html" title="Information about invitation">Invitation</a></li>
<li class="leaf"><a href="networklayer.html" title="Information about the network layer">Network Layer</a></li>
<li class="expanded"><a href="sharedsession.html" title="Information about shared session">Shared Session</a><ul class="menu"><li class="first last leaf"><a href="activities.html" title="Information about activities">Activities</a></li>
</ul></li>
<li class="last leaf"><a href="ui.html" title="Information about user interface">User Interface</a></li>
</ul></li>
<li class="expanded"><a href="research.html" title="Research">Research</a><ul class="menu"><li class="first leaf"><a href="bibliography.html" title="Saros related literature">Bibliography</a></li>
<li class="last leaf"><a href="relatedwork.html">Related Work</a></li>
</ul></li>
<li class="last leaf"><a href="contact.html">Contact</a></li>
</ul></div><!-- end main-menu -->
</div> <!-- /#header -->
<div id="content-body">
<div class="breadcrumb"><h2 class="element-invisible">You are here</h2><nav class="breadcrumb"><a href="index.html">Home</a> » <a href="setup.html" title="Learn how to use Saros">Installation & Set-Up</a> » Getting Started with Saros</nav></div>
<section id="main" role="main" class="clear">
<a id="main-content"></a>
<h1 class="title" id="page-title">Getting Started with Saros</h1> <div class="region region-content">
<div id="block-block-7" class="block block-block">
<div class="content">
<!--
<blockquote class="twitter-tweet" data-lang="de"><p lang="en" dir="ltr">You can now create new accounts for our XMPP server <a href="https://t.co/orK3opX3UF">https://t.co/orK3opX3UF</a> (and change your password or delete existing accounts) through the website <a href="https://t.co/ZGRjEKEP0K">https://t.co/ZGRjEKEP0K</a>. You can still manage your account and friends-list through the Saros interface.</p>
<p>— Saros Project (@saros_project) <a href="https://twitter.com/saros_project/status/1011240661201321984?ref_src=twsrc%5Etfw">25. Juni 2018</a></p></blockquote>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script><p>--><br /><blockquote class="twitter-tweet" data-lang="de">
<p dir="ltr" lang="en" xml:lang="en">You can now create new accounts for our XMPP server saros-con.imp.fu-berlin.de (and change your password or delete existing accounts) through the website <a href="https://saros-con.imp.fu-berlin.de:5280/register/">https://saros-con.imp.fu-berlin.de:5280/register/</a>. You can still manage your account and friends-list through the Saros interface.</p>
<p>— Saros Project (@saros_project) <a href="https://twitter.com/saros_project/status/1011240661201321984?ref_src=twsrc%5Etfw">25. Juni 2018</a></p></blockquote>
</div>
</div> <!-- /.block -->
<div id="block-system-main" class="block block-system">
<div class="content">
<span property="dc:title" content="Getting Started with Saros" class="rdf-meta element-hidden"></span><span property="sioc:num_replies" content="0" datatype="xsd:integer" class="rdf-meta element-hidden"></span>
<div class="content">
<div class="field field-name-body field-type-text-with-summary field-label-hidden"><div class="field-items"><div class="field-item even" property="content:encoded"><p>Here you will find a guideline <strong>on how to set up Saros</strong>.</p>
<p>After that you might want to find out <strong>what Saros can do</strong>: Here is the complete <a href="features.html">feature list</a>.</p>
<ul><li>First steps
<ul><li><a href="GettingStarted.html#Step%201:%20Connecting">Step 1: Connection</a></li>
<li><a href="GettingStarted.html#Step%202:%20Adding%20buddies">Step 2: Adding contacts</a></li>
<li><a href="GettingStarted.html#Step%203:%20Starting%20and%20Joining%20Sessions">Step 3: Starting and joining sessions</a></li>
</ul></li>
<li>Exploring Saros
<ul><li><a href="GettingStarted.html#Step%204:%20Exploring%20the%20Saros%20View">Step 4: Exploring the Saros View</a></li>
<li><a href="GettingStarted.html#Step%205:%20Explore%20the%20Saros%20Toolbar">Step 5: Exploring the Saros Toolbar</a></li>
<li><a href="GettingStarted.html#Good%20To%20Know">Good to know</a></li>
</ul></li>
</ul><hr /><h2><a name="Step 0: The Host" id="Step 0: The Host"></a>The Host</h2>
<p>Before we get started you should know that Saros is a host-based system.</p>
<p>To get familiar with this concept check out our comic:</p>
<p><a href="host-comic.html"><img alt="" src="saros/sites/saros-project.org/files/small_6-1_host-comic_frame-1.jpg" style="width: 90px; height: 90px; margin-left: 5px; margin-right: 5px;" /><img alt="" src="saros/sites/saros-project.org/files/small_6-1_host-comic_frame-2.jpg" style="width: 90px; height: 90px; margin-left: 5px; margin-right: 5px;" /><img alt="" src="saros/sites/saros-project.org/files/small_6-1_host-comic_frame-3.jpg" style="width: 90px; height: 90px; margin-left: 5px; margin-right: 5px;" /><img alt="" src="saros/sites/saros-project.org/files/small_6-1_host-comic_frame-4.jpg" style="width: 90px; height: 90px; margin-left: 5px; margin-right: 5px;" /></a> <img alt="" src="saros/sites/saros-project.org/files/small_host-comic_frame-5.jpg" style="width: 90px; height: 90px;" /><img alt="" src="saros/sites/saros-project.org/files/small_host-comic_frame-6.jpg" style="width: 90px; height: 90px;" /><img alt="" src="saros/sites/saros-project.org/files/small_host-comic_frame-7.jpg" style="width: 90px; height: 90px;" /></p>
<hr /><h2>First steps</h2>
<h3><a name="Step 1: Connecting" id="Step 1: Connecting"></a>Step 1: Connecting</h3>
<p>You need an <strong>XMPP account</strong> to use Saros.</p>
<ol start="1" style="list-style-type: lower-alpha;"><li>You can <strong>create a new account</strong> within Saros by using the FU-Berlin servers.</li>
<li>You can <strong>use an existing account.</strong><br /> For example your Google, GMX, or web.de mail address. <strong>They are valid XMPP accounts</strong>.<br />To use your Google account you have to allow less secure apps access your account, see<br /><a href="https://support.google.com/accounts/answer/6010255?hl=en">https://support.google.com/accounts/answer/6010255?hl=en</a><br />Unfortunately, gmx and web.de accounts do not work currently.<br /> </li>
</ol><p>To do that simply start the <em>Saros Configuration</em> wizard (<em>Menu > Saros > Start Saros Configuration</em>)</p>
<p><img alt="Connecting to Server" src="sites/saros-project.org/files/1_GettingStartedCreateAccount_0.png" style="width: 700px; height: 425px;" /></p>
<h3><a name="Step 2: Adding buddies" id="Step 2: Adding buddies"></a>Step 2: Adding contacts</h3>
<p>To add a contact to your list you need to <strong>know his/her XMPP ID</strong>.</p>
<p><strong>After entering your partner's XMPP ID</strong>, a message will be sent to your contact.<br /> Once s/he accepts your request you will be able to see his/her <strong>online status in your contact list</strong>.</p>
<p><img alt="Adding buddies" src="sites/saros-project.org/files/2_GettingStartedAddContacts.png" style="width: 700px; height: 432px;" /></p>
<h3><a name="Step 3: Starting and Joining Sessions" id="Step 3: Starting and Joining Sessions"></a>Step 3: Starting and joining sessions</h3>
<p>You can work together with your contacts by either <strong>starting your own session</strong> or by <strong>being invited to one</strong>.</p>
<p>When <strong>starting</strong> a session, <strong>Saros will copy the project</strong> to the computer of your invited contacts.</p>
<p><img alt="Share Projects" src="sites/saros-project.org/files/3_GettingStartedShareProjects_0.png" style="width: 700px; height: 368px;" /></p>
<h4><a name="Step 3: a) Start a session" id="Step 3: a) Start a session"></a>a) Start a session (<a href="GettingStarted.html#Step%200:%20The%20Host">host</a>)</h4>
<ol><li>Right-click on...<br /><ol start="1" style="list-style-type: lower-alpha;"><li>a <strong>project</strong> in your <strong>Package Explorer</strong> and select <em>Share With</em><br /> or</li>
<li>a <strong>contact</strong> in the <strong>Saros View</strong> and select <em>Work Together on</em></li>
</ol></li>
<li>Wait for your contacts to accept the <strong>session invitation</strong></li>
</ol><p>Want to know more about the Saros host role? Check out our comic <a href="host-comic.html" target="_self">here</a>.</p>
<h4><a name="Step 3: b) Join a session" id="Step 3: b) Join a session"></a>b) Join a session (client)</h4>
<ol><li>Wait for a <strong>session invitation</strong> to appear on your screen</li>
<li>Click <em>Accept</em> to <strong>accept the invitation</strong></li>
<li>Tell Saros <strong>where to save the incoming project</strong>:<br /><ol start="1" style="list-style-type: lower-alpha;"><li>You can create a <strong>new project</strong>, or</li>
<li>synchronize with an <strong>already existing project</strong> on your computer.</li>
</ol></li>
<li>Select <em>Finish</em> and wait for the project to be copied to your computer</li>
</ol><h4><a name="Step 3: c) Additional information" id="Step 3: c) Additional information"></a>Additional information:</h4>
<ul><li>If you accept an invitation and decide to synchronie the incoming project with your own copy, Saros will automatically add, change, or delete all files as necessary.</li>
<li>Saros will share all files which are not marked as <em>derived</em> by Eclipse, because it should be possible to recreate such files (<code>.class</code> files for instance) at the client's side. If you use a build tool such as Ant, it might be necessary to manually set the resulting files or folders to <em>derived</em> on both the host's side (so they won't be copied to the client) and the client's side (otherwise the files will be deleted on synchronization).</li>
</ul><hr /><h2>Exploring Saros</h2>
<h3><a name="Step 4: Exploring the Saros View" id="Step 4: Exploring the Saros View"></a>Step 4: Exploring the Saros View</h3>
<p>The Saros View consists of three parts</p>
<ul><li>the contact list</li>
<li>the session list</li>
<li>the chat area</li>
</ul><p>The <strong>contact list</strong> is where all <strong>your contacts</strong> are, allowing you to check their availability, send them instant messages, and invite them to Saros sessions.</p>
<p>When you are in a Saros session you will see all <strong>participants in the session list</strong>. Saros also provides <strong>instant chat messaging</strong> to accompany your sessions.<br /> Whenever you begin a Saros session, a <strong>chat session</strong> is also automatically started.</p>
<p><img alt="saros_view_with_contextmenu" src="sites/saros-project.org/files/saros_view_with_contextmenu_1.png" style="width: 100%;" /></p>
<h3><a name="Step 5: Explore the Saros Toolbar" id="Step 5: Explore the Saros Toolbar"></a>Step 5: Exploring the Saros Toolbar</h3>
<h4><a name="Step 5: a) General" id="Step 5: a) General"></a>General</h4>
<p><img alt="connect button" src="sites/saros-project.org/files/saros_connect_button.png" style="width: 21px; height: 21px;" /><strong>Connecting:</strong></p>
<p style="margin-left: 40px;">Click here to connect or disconnect from the server, or to switch between user accounts if you have more than one. When you connect, you will see information about your contacts (including whether they are connected and also whether they support Saros).</p>
<p><img alt="add buddy icon" src="sites/saros-project.org/files/saros_addbuddy_button.png" style="width: 21px; height: 21px;" /><strong>Add Contact:</strong></p>
<p style="margin-left: 40px;">To add a new contact click here (you will need the full XMPP address of your contact in the format: <code>username@server</code>).</p>
<p><img alt="saros preferences button" src="sites/saros-project.org/files/preferences_open_tsk.png" style="width: 16px; height: 16px;" /><strong>Open Saros preferences:</strong></p>
<p style="margin-left: 40px;">Opens the Saros section of the Eclipse preferences. This is a shortcut for <em>Window > Preferences > Saros</em>.</p>
<p><img alt="saros consistency button" src="sites/saros-project.org/files/saros_consistency_button_0.png" style="width: 23px; height: 20px;" /><strong>Inconsistency repair</strong><strong>:</strong></p>
<p style="margin-left: 40px;">Sometimes accidents can happen and your copy of the project can become out of sync with the host's copy. When it does, this button will light up. When you click it, the inconsistencies will be repaired.</p>
<p><img alt="follow mode" src="sites/saros-project.org/files/followmode_0.png" style="width: 21px; height: 20px;" /><strong>Switch Follow Mode on/off</strong><strong>:</strong></p>
<p style="margin-left: 40px;">You can turn the Follow Mode on and of. In Follow Mode Saros will automatically sync your Eclipse view with the user you are following, opening shared files the user is opening, and automatically scroll to the visible part of the editor of open files, so you always see what the followed user sees.</p>
<p><img alt="saros leave button " src="sites/saros-project.org/files/saros_leave_button.png" style="width: 21px; height: 21px;" /><strong>Leave the session:</strong></p>
<p style="margin-left: 40px;">Click here to leave the current session. If you are the <a href="GettingStarted.html#Step%200:%20The%20Host">host</a>, the session will be closed and all participants will be ejected from the session.</p>
<h4><a name="Step 5: b) Context Menu Tasks" id="Step 5: b) Context Menu Tasks"></a>Context Menu</h4>
<p><img alt="write access" src="sites/saros-project.org/files/buddy_saros_obj.png" style="width: 16px; height: 16px;" /><strong>Grant Write Access:</strong></p>
<p style="margin-left: 40px;">Gives the selected participant write access.</p>
<p><img alt="read-only access" src="sites/saros-project.org/files/participant_readonly_0.png" style="width: 19px; height: 20px;" /><strong>Restrict to Read-Only Access:</strong></p>
<p style="margin-left: 40px;">Removes the write access right from the selected participant. The affected participant will only have read access afterwards.</p>
<p><img alt="follow mode icon" src="sites/saros-project.org/files/followmode_0.png" style="width: 21px; height: 20px;" /><strong>Follow Participant:</strong></p>
<p style="margin-left: 40px;">Follows the selected participant as described in section <a href="GettingStarted.html#Good%20to%20Know:%20Follow_Mode">Follow Mode</a>.</p>
<p><img alt="jump icon" src="sites/saros-project.org/files/jump.png" style="width: 16px; height: 16px;" /><strong>Jump to Position:</strong></p>
<p style="margin-left: 40px;">Jumps to the cursor position of the selected participant and open the corresponding file if necessary.</p>
<p><strong><img alt="open chat image" src="sites/saros-project.org/files/chat_misc.png" style="width: 16px; height: 16px;" /> Open chat:</strong></p>
<p style="margin-left: 40px;">Opens a chat with this contact on the right side.</p>
<p><img alt="share file icon" src="sites/saros-project.org/files/saros_sharefile_button.png" style="width: 21px; height: 21px;" /><strong>Send File:</strong></p>
<p style="margin-left: 40px;">Gives you the opportunity to select a file to be sent to the selected participant.</p>
<h3><a name="Good To Know" id="Good To Know"></a>Good to know</h3>
<h4><a name="Good to Know: User_Roles" id="Good to Know: User_Roles"></a>User Roles</h4>
<p>By default all participants of a session have <strong>writing access</strong>. To restrict or grant this access to other participants, right-click on that user in the session list and select <em>Restrict to read-only access</em> or <em>Grant writing access</em>. This can <strong>only be done by the <a href="GettingStarted.html#Step%200:%20The%20Host">host</a></strong>.</p>
<h4><a name="Good to Know: Follow_Mode" id="Good to Know: Follow_Mode"></a>Follow Mode</h4>
<p>You can use this feature to follow a single participant as s/he navigates the project and performs changes. When you follow a participant:</p>
<ul><li>Whenever s/he opens a file on his/her computer, it is opened on yours too.</li>
<li>Any time s/he switches to view a different file, it is switched on yours.</li>
<li>As s/he scrolls through a file, the viewpoint is moved on your computer also, so that you see what s/he sees.</li>
</ul><h4><a name="Good to Know: Staying_Aware" id="Good to Know: Staying_Aware"></a>Staying Aware of your Fellow Participants</h4>
<p>There are multiple ways of staying aware of what a driver is currently doing:</p>
<ul><li>In the package explorer (or resource navigator):
<ul><li><img alt="active file" src="sites/saros-project.org/files/active_file.png" style="width: 21px; height: 21px;" /> A colored dot decorates the file that a participant has currently in focus. The color resembles the color of the active user.</li>
<li><img alt="shared file" src="sites/saros-project.org/files/shared_file.png" style="width: 21px; height: 21px;" /> A blue arrow decorates a file that is shared with other participants.</li>
</ul></li>
<li>Cursors:<br /> The position of a participant's cursor appears in the file in his/her color.</li>
<li>Selections:<br /> Any text selected by a participant also appears highlighted in the file.</li>
<li>Changes:<br /> If a participant writes something, his/her text will appear highlighted in his/her color.</li>
<li>Locate participants:<br /> On the right side of editors you can see colored bars representing the viewports of each user. These show which part of the file each user can see.</li>
<li>Follow participants:<br /> Follow mode allows you to follow all movements of another user as s/he moves within and between files. In the Session list, right click on the user you wish to follow and select Follow Participant.</li>
</ul></div></div></div> </div>
<footer>
</footer>
</div>
</div> <!-- /.block -->
</div>
<!-- /.region -->
</section> <!-- /#main -->
</div> <!-- end content-body -->
<div class="clear"></div>
<div id="footer" class="clearfix">
<div class="clear"></div>
<div class="region region-footer">
<div id="block-block-2" class="block block-block">
<div class="content">
<p><a href="http://www.mi.fu-berlin.de/fb/impressum/" target="_blank">Impressum</a> — <a href="index.html%3Fq=user.html">Internal login</a></p>
</div>
</div> <!-- /.block -->
</div>
<!-- /.region -->
<div class="clear"></div>
<div id="copyright">Copyright © 2019, Saros</div>
</div> <!-- /#footer -->
</div> <!-- /#wrapper -->
<script src="http://code.jquery.com/ui/1.10.3/jquery-ui.js"></script>
<script>
<!--//--><![CDATA[// ><!--
jQuery(document).ready( function($) {
$( ".known-issue-box" ).accordion({
active: false,
heightStyle: "content",
collapsible: true
});
$( ".known-issue-box" ).css( "visibility", "visible" ); });
//--><!]]>
</script> </body>
</html>