diff options
Diffstat (limited to 'tde-i18n-it/docs/tdesdk/umbrello')
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/Makefile.am | 4 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/Makefile.in | 635 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/authors.docbook | 46 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/code_import_and_generation.docbook | 163 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/credits.docbook | 11 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/index.cache.bz2 | bin | 0 -> 18444 bytes | |||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/index.docbook | 85 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/introduction.docbook | 57 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/other_features.docbook | 76 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/uml_basics.docbook | 782 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdesdk/umbrello/working_with_umbrello.docbook | 413 |
11 files changed, 2272 insertions, 0 deletions
diff --git a/tde-i18n-it/docs/tdesdk/umbrello/Makefile.am b/tde-i18n-it/docs/tdesdk/umbrello/Makefile.am new file mode 100644 index 00000000000..5c1b8e5bc2d --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = it +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/tde-i18n-it/docs/tdesdk/umbrello/Makefile.in b/tde-i18n-it/docs/tdesdk/umbrello/Makefile.in new file mode 100644 index 00000000000..b82636ab07f --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/Makefile.in @@ -0,0 +1,635 @@ +# Makefile.in generated by automake 1.10.1 from Makefile.am. +# KDE tags expanded automatically by am_edit - $Revision: 483858 $ +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +subdir = docs/tdesdk/umbrello +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \ + $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +#>- RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ +#>- html-recursive info-recursive install-data-recursive \ +#>- install-dvi-recursive install-exec-recursive \ +#>- install-html-recursive install-info-recursive \ +#>- install-pdf-recursive install-ps-recursive install-recursive \ +#>- installcheck-recursive installdirs-recursive pdf-recursive \ +#>- ps-recursive uninstall-recursive +#>+ 7 +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive nmcheck-recursive bcheck-recursive +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +#>+ 1 +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +ARTSCCONFIG = @ARTSCCONFIG@ +AUTOCONF = @AUTOCONF@ +AUTODIRS = @AUTODIRS@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CONF_FILES = @CONF_FILES@ +CYGPATH_W = @CYGPATH_W@ +DCOPIDL = @DCOPIDL@ +DCOPIDL2CPP = @DCOPIDL2CPP@ +DCOPIDLNG = @DCOPIDLNG@ +DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@ +DEFS = @DEFS@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +GMSGFMT = @GMSGFMT@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +KCFG_DEPENDENCIES = @KCFG_DEPENDENCIES@ +KCONFIG_COMPILER = @KCONFIG_COMPILER@ +KDECONFIG = @KDECONFIG@ +KDE_EXTRA_RPATH = @KDE_EXTRA_RPATH@ +KDE_RPATH = @KDE_RPATH@ +KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +MAKEKDEWIDGETS = @MAKEKDEWIDGETS@ +MCOPIDL = @MCOPIDL@ +MEINPROC = @MEINPROC@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +TOPSUBDIRS = @TOPSUBDIRS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMLLINT = @XMLLINT@ +X_RPATH = @X_RPATH@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +am__leading_dot = @am__leading_dot@ +am__tar = @am__tar@ +am__untar = @am__untar@ +#>- bindir = @bindir@ +#>+ 2 +DEPDIR = .deps +bindir = @bindir@ +build_alias = @build_alias@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host_alias = @host_alias@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +kde_appsdir = @kde_appsdir@ +kde_bindir = @kde_bindir@ +kde_confdir = @kde_confdir@ +kde_datadir = @kde_datadir@ +kde_htmldir = @kde_htmldir@ +kde_icondir = @kde_icondir@ +kde_kcfgdir = @kde_kcfgdir@ +kde_libs_htmldir = @kde_libs_htmldir@ +kde_libs_prefix = @kde_libs_prefix@ +kde_locale = @kde_locale@ +kde_mimedir = @kde_mimedir@ +kde_moduledir = @kde_moduledir@ +kde_servicesdir = @kde_servicesdir@ +kde_servicetypesdir = @kde_servicetypesdir@ +kde_sounddir = @kde_sounddir@ +kde_styledir = @kde_styledir@ +kde_templatesdir = @kde_templatesdir@ +kde_wallpaperdir = @kde_wallpaperdir@ +kde_widgetdir = @kde_widgetdir@ +tdeinitdir = @tdeinitdir@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +xdg_appsdir = @xdg_appsdir@ +xdg_directorydir = @xdg_directorydir@ +xdg_menudir = @xdg_menudir@ +KDE_LANG = it +#>- SUBDIRS = $(AUTODIRS) +#>+ 1 +SUBDIRS =. +KDE_DOCS = AUTO +KDE_MANS = AUTO +#>- all: all-recursive +#>+ 1 +all: docs-am all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) +#>- @for dep in $?; do \ +#>- case '$(am__configure_deps)' in \ +#>- *$$dep*) \ +#>- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ +#>- && exit 0; \ +#>- exit 1;; \ +#>- esac; \ +#>- done; \ +#>- echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdesdk/umbrello/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/tdesdk/umbrello/Makefile +#>+ 12 + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdesdk/umbrello/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdesdk/umbrello/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdesdk/umbrello/Makefile.in +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +# This directory's subdirectories are mostly independent; you can cd +# into them and run `make' without going through this Makefile. +# To change the values of `make' variables: instead of editing Makefiles, +# (1) if the variable is set in `config.status', edit `config.status' +# (which will cause the Makefiles to be regenerated when you run `make'); +# (2) otherwise, pass the desired values on the `make' command line. +$(RECURSIVE_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +$(RECURSIVE_CLEAN_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + rev=''; for subdir in $$list; do \ + if test "$$subdir" = "."; then :; else \ + rev="$$subdir $$rev"; \ + fi; \ + done; \ + rev="$$rev ."; \ + target=`echo $@ | sed s/-recursive//`; \ + for subdir in $$rev; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done && test -z "$$fail" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done + +ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonemtpy = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$tags $$unique; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$tags$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$tags $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && cd $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) $$here + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +#>- distdir: $(DISTFILES) +#>+ 1 +distdir: distdir-nls $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done + list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + distdir=`$(am__cd) $(distdir) && pwd`; \ + top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ + (cd $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$top_distdir" \ + distdir="$$distdir/$$subdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +#>- uninstall: uninstall-recursive +#>+ 1 +uninstall: uninstall-docs uninstall-nls uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +#>- clean: clean-recursive +#>+ 1 +clean: kde-rpo-clean clean-recursive + +#>- clean-am: clean-generic mostlyclean-am +#>+ 1 +clean-am: clean-docs clean-bcheck clean-generic mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +info: info-recursive + +info-am: + +#>- install-data-am: +#>+ 1 +install-data-am: install-docs install-nls + +install-dvi: install-dvi-recursive + +install-exec-am: + +install-html: install-html-recursive + +install-info: install-info-recursive + +install-man: + +install-pdf: install-pdf-recursive + +install-ps: install-ps-recursive + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \ + install-strip + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am clean clean-generic ctags \ + ctags-recursive distclean distclean-generic distclean-tags \ + distdir dvi dvi-am html html-am info info-am install \ + install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ + tags-recursive uninstall uninstall-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: + +#>+ 2 +KDE_DIST=uml_basics.docbook index.docbook credits.docbook code_import_and_generation.docbook index.cache.bz2 Makefile.in other_features.docbook introduction.docbook working_with_umbrello.docbook authors.docbook Makefile.am + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) other_features.docbook code_import_and_generation.docbook index.docbook introduction.docbook credits.docbook working_with_umbrello.docbook uml_basics.docbook authors.docbook + @if test -n "$(MEINPROC)"; then echo $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; fi + +docs-am: index.cache.bz2 + +install-docs: docs-am install-nls + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello + @for base in other_features.docbook code_import_and_generation.docbook index.docbook introduction.docbook credits.docbook working_with_umbrello.docbook uml_basics.docbook authors.docbook ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/$$base ;\ + done + +uninstall-nls: + for base in other_features.docbook code_import_and_generation.docbook index.docbook introduction.docbook credits.docbook working_with_umbrello.docbook uml_basics.docbook authors.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/umbrello/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in other_features.docbook code_import_and_generation.docbook index.docbook introduction.docbook credits.docbook working_with_umbrello.docbook uml_basics.docbook authors.docbook ; do \ + cp $(srcdir)/$$file $(distdir); \ + done + +#>+ 15 +force-reedit: + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdesdk/umbrello/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdesdk/umbrello/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdesdk/umbrello/Makefile.in + + +#>+ 21 +clean-bcheck: + rm -f *.bchecktest.cc *.bchecktest.cc.class a.out + +bcheck: bcheck-recursive + +bcheck-am: + @for i in ; do \ + if test $(srcdir)/$$i -nt $$i.bchecktest.cc; then \ + echo "int main() {return 0;}" > $$i.bchecktest.cc ; \ + echo "#include \"$$i\"" >> $$i.bchecktest.cc ; \ + echo "$$i"; \ + if ! $(CXX) $(DEFS) -I. -I$(srcdir) -I$(top_builddir) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(KDE_CXXFLAGS) --dump-class-hierarchy -c $$i.bchecktest.cc; then \ + rm -f $$i.bchecktest.cc; exit 1; \ + fi ; \ + echo "" >> $$i.bchecktest.cc.class; \ + perl $(top_srcdir)/admin/bcheck.pl $$i.bchecktest.cc.class || { rm -f $$i.bchecktest.cc; exit 1; }; \ + rm -f a.out; \ + fi ; \ + done + + +#>+ 3 +final: + $(MAKE) all-am + +#>+ 3 +final-install: + $(MAKE) install-am + +#>+ 3 +no-final: + $(MAKE) all-am + +#>+ 3 +no-final-install: + $(MAKE) install-am + +#>+ 3 +kde-rpo-clean: + -rm -f *.rpo + +#>+ 3 +nmcheck: +nmcheck-am: nmcheck diff --git a/tde-i18n-it/docs/tdesdk/umbrello/authors.docbook b/tde-i18n-it/docs/tdesdk/umbrello/authors.docbook new file mode 100644 index 00000000000..e0176db9416 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/authors.docbook @@ -0,0 +1,46 @@ +<chapter id="authors"> +<title +>Autori e storia</title> +<para +>Il progetto è stato iniziato da Paul Hengsen come uno dei suoi progetti universitari. Il nome originale dell'applicazione era <application +>UML Modeller</application +>. Paul fece tutto lo sviluppo fino alla fine del 2001, quando il programma raggiunse la versione 1.0. </para> +<para +>La versione 1.0 offriva già molte funzionalità, ma dopo che il progetto è stato valutato all'università di Paul, altri sviluppatori hanno potuto unirsi dando contributi di valore a <application +>UML Modeller</application +>, come passare da un file binario a un file &XML;, supporto per più tipi di diagrammi &UML;, generazione e importazione di codice solo per menzionarne alcuni. </para> +<para +>Paul si è dovuto ritirare dalla squadra di sviluppo nell'estate 2002, ma, come software libero, il programma continua a migliorare e evolversi, ed è mantenuto da un gruppo di sviluppatori da diverse parti del mondo. Nel settembre 2002 il progetto ha cambiato il suo nome da <application +>&UML; Modeller</application +> in &umbrello;. Ci sono diverse ragioni per il cambio di nome, la più importante è che solo <quote +>uml</quote +>, come era comunemente noto, era un nome troppo generico e causava problemi con alcune distribuzioni. L'altra ragione importante è che gli sviluppatori pensano che <application +>Umbrello</application +> sia un nome molto più bello. </para> +<para +>Lo sviluppo di &umbrello; e le discussioni sugli sviluppi futuri del programma sono aperti e si trovano su Internet. Se vuoi contribuire al progetto, non esitare a contattare gli sviluppatori. Ci sono molti modi in cui puoi aiutare &umbrello;: </para> +<itemizedlist> +<listitem +><para +>Fare rapporti di errori o suggerire miglioramenti</para +></listitem> +<listitem +><para +>Correggere errori o aggiungere funzionalità</para +></listitem> +<listitem +><para +>Scrivere della buona documentazione o tradurla in altre lingue</para +></listitem> +<listitem +><para +>E ovviamente... scrivere codice con noi!</para +></listitem> +</itemizedlist> +<para +>Come vedi, ci sono molti modi in cui puoi contribuire. Tutti sono molto importanti e tutti sono i benvenuti a partecipare. </para> +<para +>Gli sviluppatori di &umbrello; possono essere raggiunti a <email +>[email protected]</email +>. </para> +</chapter> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/code_import_and_generation.docbook b/tde-i18n-it/docs/tdesdk/umbrello/code_import_and_generation.docbook new file mode 100644 index 00000000000..3670b03fde9 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/code_import_and_generation.docbook @@ -0,0 +1,163 @@ +<chapter id="code-import-generation"> +<title +>Importazione e generazione di codice</title> +<para +>&umbrello; è uno strumento di modellazione &UML;, e come tale il suo obiettivo principale è aiutarti <emphasis +>nell'analisi e nella progettazione</emphasis +> dei tuoi sistemi. Tuttavia, per facilitare la transizione tra il tuo progetto e la tua <emphasis +>implementazione</emphasis +>, &umbrello; ti permette di generare codice sorgente in diversi linguaggi di programmazione come inizio. Inoltre, se vuoi iniziare a usare &UML; in un progetto C++ già cominciato, &umbrello; può aiutarti a creare un modello del tuo sistema dal codice sorgente analizzandolo e importando le classi trovateci. </para> +<sect1 id="code-generation"> +<title +>Generazione di codice</title> +<para +>&umbrello; può generare codice sorgente per vari linguaggi di programmazione in base al tuo modello &UML; per aiutarti a iniziare l'implementazione del tuo progetto. Il codice generato consiste di dichiarazioni di classi, con i loro metodi e attributi in modo che tu possa <quote +>riempire gli spazi vuoti</quote +> fornendo la funzionalità delle operazioni delle tue classi. </para> +<para +>&umbrello; 1.2 ha supporto per la generazione di codice ActionScript, Ada, C++, CORBA IDL, &Java;, JavaScript, <acronym +>PHP</acronym +>, Perl, Python, SQL e XMLSchema. </para> +<sect2 id="generate-code"> +<title +>Generare il codice</title> +<para +>Per generare il codice con &umbrello;, devi prima creare o caricare un modello contenente almeno una classe. Quando sei pronto per iniziare a scrivere del codice, seleziona la voce <guimenuitem +>Assistente per la generazione del codice</guimenuitem +> dal menu <guimenuitem +>Codice</guimenuitem +> per avviare un assistente che ti guiderà attraverso il processo di generazione del codice. </para> +<para +>Il primo passo è selezionare le classi per le quali vuoi generare del codice sorgente. Come impostazione predefinita tutte le classi del tuo modello sono selezionate, e puoi rimuovere quelle per le quali non vuoi generare codice spostandole nell'elenco sulla sinistra. </para> +<para +>Il prossimo passo dell'assistente ti permette di modificare i parametri che il generatore di codice userà scrivendo il tuo codice. Sono disponibili le seguenti opzioni: </para> +<para> +<screenshot> +<screeninfo +>Opzioni di generazione del codice</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="generation-options.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Opzioni per la generazione del codice in &umbrello;</phrase> + </textobject> + <caption> + <para +>Opzioni per la generazione del codice in &umbrello; </para> + </caption> + </mediaobject> +</screenshot> +</para> +<sect3 id="generation-options"> +<title +>Opzioni di generazione</title> +<!-- LW; to rearrange --> + +<sect4> +<title +>Verbosità del codice</title> +<para +>L'opzione <guilabel +>Scrivi commenti di documentazione anche se vuoto</guilabel +> dice al generatore di codice di scrivere commenti nello stile /** bla */ anche se i blocchi di commento sono vuoti. Se hai aggiunto della documentazione alle tue classi, metodi o attributi nel tuo modello, il generatore di codice scriverà questi commenti come documentazione <application +>Doxygen</application +>, indipendentemente da cosa imposti qui, ma se selezioni questa opzione &umbrello; scriverà blocchi di commento per tutte le classi, i metodi e gli attributi anche se non c'è documentazione nel modello, nel qual caso dovresti documentare le tue classi in seguito, direttamente nel codice sorgente. </para> +<para +><guilabel +>Scrivi commenti per le sezioni anche se la sezione è vuota</guilabel +> fa in modo che &umbrello; scriva commenti nel codice sorgente per delimitare le diverse sezioni di una classe. Per esempio <quote +>metodi pubblici</quote +> o <quote +>Attributi</quote +> prima delle sezioni corrispondente. Se selezioni questa opzione &umbrello; scriverà commenti per tutte le sezioni della classe anche se la sezione è vuota. Per esempio, scriverebbe un commento che dice <quote +>metodi protetti</quote +> anche se non ci sono metodi protetti nella tua classe. </para> +</sect4> +<sect4> +<title +>Cartelle</title> +<para +><guilabel +>Scrivi tutti i file generati nella cartella</guilabel +>. Qui dovresti scegliere la cartella dove vuoi che &umbrello; metta il sorgente generato. </para> +<para +>L'opzione <guilabel +>Includi i file di intestazione dalla cartella</guilabel +> ti permette di inserire un'intestazione all'inizio di ogni file generato. I file d'intestazione possono contenere informazioni di copyright o licenza e contenere variabili che sono valutate al momento della generazione. Puoi dare un'occhiata ai modelli di file d'intestazione forniti con &umbrello; per vedere come usare queste variabili per sostituire il tuo nome o la data attuale al momento della generazione. </para> +</sect4> +<sect4> +<title +>Politica di sovrascrittura</title> +<!-- FIXME update for Umbrello 1.2's new C++ and Java code generators --> +<para +>Questa opzione dice a &umbrello; cosa fare se il file che vuole creare esiste già nella cartella di destinazione. &umbrello; <emphasis +>non può modificare file sorgente esistenti</emphasis +>, quindi devi scegliere tra sovrascrivere il file esistente, saltare la generazione di un certo file o lasciare che &umbrello; scelga un nome file diverso. Se scegli l'opzione di usare un nome diverso, &umbrello; aggiungerà un suffisso al nome file. </para> +</sect4> +<sect4> +<title +>Linguaggio</title> +<para +>&umbrello; genererà codice, come impostazione predefinita, nel linguaggio che hai selezionato come Linguaggio attivo, ma con l'Assistente per la generazione del codice hai l'opzione di cambiarlo in un altro linguaggio. </para> +</sect4> +</sect3 +><!--generation-options--> +<sect3 id="generation-wizard-generation"> +<title +>Generazione con l'assistente di generazione</title> +<para +>Il terzo e ultimo passo dell'assistente mostra lo stato del processo di generazione del codice. Devi solo fare clic sul pulsante Genera per avere le tue classi scritte. </para> +<para +>Nota che le opzioni che selezioni nell'assistente per la generazione del codice sono valide solo per la generazione corrente. La prossima volta che esegui l'assistente dovrai riselezionare tutte le opzioni (la cartella delle intestazioni, la politica di sovrascrittura, e così via). Puoi impostare i valori predefiniti usati da &umbrello; nella sezione <guilabel +>Generazione del codice</guilabel +> nelle impostazioni di &umbrello;, disponibile a <menuchoice +><guimenu +>Impostazioni</guimenu +><guimenuitem +>Configura &umbrello;...</guimenuitem +></menuchoice +> </para> +<para +>Se devi impostare le tue opzioni di generazione del codice ai valori giusti e vuoi subito generare del codice subito senza passare per l'assistente, puoi selezionare l'intero <guimenuitem +>Genera tutto il codice</guimenuitem +> dal menu Codice. Ciò genererà codice per tutte le classi nel tuo modello usando le impostazioni correnti (incluse la cartella di output e la politica di sovrascrittura, quindi usalo con attenzione). </para> +</sect3> +</sect2 +><!--generate-code--> +</sect1 +> <!--code-generation--> +<sect1 id="code-import"> +<title +>Importazione di codice</title> +<para +>&umbrello; può importare codice sorgente dai tuoi progetti esistenti per aiutarti a costruire un modello del tuo sistema. &umbrello; 1.2 supporta solo codice sorgente C++, ma altri linguaggi dovrebbero essere disponibili in versioni future. </para> +<para +>Per importare classi nel tuo modello, seleziona la voce <guimenuitem +>Importa classi</guimenuitem +> dal menu <guimenu +>Codice</guimenu +>. Nella finestra di dialogo dei file seleziona i file contenenti le dichiarazioni delle classi C++ e premi OK. Le classi saranno importare e le troverai come parte del tuo modello nella vista ad albero. Nota che &umbrello; non creerà nessun tipo di diagramma per mostrarti le tue classi, esse saranno solo importate nel tuo modello in modo che tu possa usarle in seguito in quasiasi diagramma tu voglia. </para> +<para> +<screenshot> +<screeninfo +>Importazione di codice</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="code-import.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Menu per importare codice sorgente in &umbrello;</phrase> + </textobject> + <caption> + <para +>Menu per importare codice sorgente in &umbrello; </para> + </caption> + </mediaobject> +</screenshot> +</para> +</sect1> +</chapter +> <!--code-import-generation--> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/credits.docbook b/tde-i18n-it/docs/tdesdk/umbrello/credits.docbook new file mode 100644 index 00000000000..3e6b0f961df --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/credits.docbook @@ -0,0 +1,11 @@ +<chapter id="copyright"> +<title +>Copyright</title> + +<para +>Copyright 2001 di Paul Hensgen</para> +<para +>Copyright 2002, 2003 degli autori di &umbrello;. Vedi <ulink url="http://uml.sf.net/developers.php" +>http://uml.sf.net/developers.php</ulink +> per maggiori informazioni</para> +&underFDL; &underGPL; </chapter> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/index.cache.bz2 b/tde-i18n-it/docs/tdesdk/umbrello/index.cache.bz2 Binary files differnew file mode 100644 index 00000000000..4d8c07c1f3c --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/index.cache.bz2 diff --git a/tde-i18n-it/docs/tdesdk/umbrello/index.docbook b/tde-i18n-it/docs/tdesdk/umbrello/index.docbook new file mode 100644 index 00000000000..96cea3d18bc --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/index.docbook @@ -0,0 +1,85 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" + "dtd/kdex.dtd" [ + <!ENTITY umbrello "<application +>Umbrello &UML; Modeller</application +>"> + <!ENTITY kappname "&umbrello;"> + <!ENTITY packagename "tdesdk"> + <!ENTITY UML "<acronym +>UML</acronym +>"> + <!ENTITY introduction-chapter SYSTEM "introduction.docbook"> + <!ENTITY uml-basics-chapter SYSTEM "uml_basics.docbook"> + <!ENTITY working-with-umbrello-chapter SYSTEM "working_with_umbrello.docbook"> + <!ENTITY code-import-and-generation-chapter SYSTEM "code_import_and_generation.docbook"> + <!ENTITY other-features-chapter SYSTEM "other_features.docbook"> + <!ENTITY authors-chapter SYSTEM "authors.docbook"> + <!ENTITY credits-chapter SYSTEM "credits.docbook"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % Italian "INCLUDE" +><!-- change language only here --> + <!-- Do not define any other entities; instead, use the entities + from kde-genent.entities and $LANG/user.entities. --> +]> + +<book id="Umbrello" lang="&language;"> +<bookinfo> +<title +>Manuale di &umbrello;</title> + +<authorgroup> +<corpauthor +>Autori di &umbrello;</corpauthor> +</authorgroup> + +<copyright> +<year +>2001</year> +<holder +>Paul Hensgen</holder> +</copyright> +<copyright> +<year +>2002, 2003</year> +<holder +>Autori di &umbrello;</holder> +</copyright> + + +<date +>2003-10-15</date> +<releaseinfo +>1.2</releaseinfo> + +<abstract> +<para +>&umbrello; aiuta il processo di sviluppo del software usando il Linguaggio di Modellazione Unificato (&UML;), uno standard industriale, per permetterti di creare diagrammi per progettare e documentare i tuoi sistemi. </para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>UML</keyword> +<keyword +>modellazione</keyword> +<keyword +>diagrammi</keyword> +<keyword +>sviluppo software</keyword> +<keyword +>sviluppo</keyword> +</keywordset> + +</bookinfo> + +&introduction-chapter; +¨-basics-chapter; +&working-with-umbrello-chapter; +&code-import-and-generation-chapter; +&other-features-chapter; +&authors-chapter; +&credits-chapter; + +</book> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/introduction.docbook b/tde-i18n-it/docs/tdesdk/umbrello/introduction.docbook new file mode 100644 index 00000000000..0d19c575903 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/introduction.docbook @@ -0,0 +1,57 @@ +<chapter id="introduction"> +<title +>Introduzione</title> + +<para +>&umbrello; è uno strumento per diagrammi &UML; che può aiutarti nel processo di sviluppo del software. Specialmente durante le fasi di analisi e progettazione di questo processo, &umbrello; ti aiuterà a ottenere un prodotto di alta qualità. &UML; può anche essere usato per documentare i tuoi progetti software per aiutare te e i tuoi colleghi sviluppatori. </para> +<para +>Avere un buon modello del tuo software è il modo migliore per comunicare con altri sviluppatori che lavorano al progetto e con i tuoi clienti. Un buon modello è estremamente importante per i progetti di dimensioni medie e grandi, ma è anche molto utile per quelli piccoli. Anche se stai lavorando su un piccolo progetto da una sola persona, un buon modello ti gioverà perché ti darà una panoramica che ti aiuterà a codificare le cose subito nel modo giusto. </para> +<para +>&UML; è il linguaggio di diagrammi usato per descrivere questi modelli. Puoi rappresentare le tue idee in &UML; usando diversi tipi di diagrammi. &umbrello; 1.2 supporta i seguenti tipi: </para> +<itemizedlist> +<listitem +><para +>Diagrammi di classi</para +></listitem> +<listitem +><para +>Diagrammi di sequenza</para +></listitem> +<listitem +><para +>Diagrammi di collaborazione</para +></listitem> +<listitem +><para +>Diagrammi di caso d'uso</para +></listitem> +<listitem +><para +>Diagrammi di stato</para +></listitem> +<listitem +><para +>Diagrammi di attività</para +></listitem> +<listitem +><para +>Diagrammi di componenti</para +></listitem> +<listitem +><para +>Diagrammi di dispiegamento</para +></listitem> +</itemizedlist> +<para +>Si possono trovare maggiori informazioni su &UML; al sito Web di <ulink url="http://www.omg.org" +><acronym +>OMG</acronym +>, http://www.omg.org</ulink +> che ha creato lo standard &UML;. </para> +<para +>Speriamo che &umbrello; ti piaccia e che ti aiuti a creare software di alta qualità. &umbrello; è software libero ed è disponibile gratis, l'unica cosa che ti chiediamo è di comunicare qualsiasi errore, problema o suggerimento agli sviluppatori di &umbrello; a <email +>[email protected]</email +> o <ulink url="http://bugs.kde.org" +>http://bugs.kde.org</ulink +>. </para> +</chapter> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/other_features.docbook b/tde-i18n-it/docs/tdesdk/umbrello/other_features.docbook new file mode 100644 index 00000000000..efc82ad5e57 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/other_features.docbook @@ -0,0 +1,76 @@ +<chapter id="other-features"> +<title +>Altre funzionalità</title> +<sect1 +> +<title +>Altre funzionalità di &umbrello;</title> +<para +>Questo capitolo spiegherà brevemente alcune altre funzionalità che &umbrello; ti offre.</para> +<sect2 id="copying-as-png"> +<title +>Copiare oggetti come immagini PNG</title> +<para +>Oltre a offrirti la funzionalità normale di copia, taglia e incolla che ti aspetteresti per copiare oggetti tra diversi diagrammi, &umbrello; può copiare oggetti come immagini PNG in modo che tu possa inserirli in un altro tipo di documento. Non hai bisogno di fare nulla di speciale per usare questa funzionalità, seleziona semplicemente un oggetto da un diagramma (Classe, Attore, &etc;) e copialo (<keycombo +>&Ctrl;<keycap +>C</keycap +></keycombo +>, o usando il menu), quindi apri un documento &kword; (o qualsiasi programma in cui puoi incollare immagini) e seleziona <guimenuitem +>Incolla</guimenuitem +>. Questa è un'ottima funzionalità per esportare parti del tuo diagramma come semplici immagini. </para> +</sect2> +<sect2 id="export-as-png"> +<title +>Esportare come immagine</title> +<para +>Puoi anche esportare un diagramma completo come immagine. L'unica cosa che devi fare è selezionare il diagramma che vuoi esportare, e l'opzione <guimenuitem +>Esporta come immagine...</guimenuitem +> dal menu <guimenu +>Diagramma</guimenu +>. </para> +</sect2> +<sect2 id="printing"> +<title +>Stampa</title> +<para +>&umbrello; ti permette di stampare diagrammi individuali. Premere il pulsante <guiicon +>Stampa</guiicon +> sulla barra delle applicazioni o selezionare l'opzione <guimenuitem +>Stampa</guimenuitem +> dal menu <guimenu +>File</guimenu +> ti porterà a una finestra di dialogo di stampa standard di &kde;, dalla quale puoi stampare i tuoi diagrammi. </para> +</sect2> +<sect2 id="logical-folders"> +<title +>Cartelle logiche</title> +<para +>Per organizzare meglio il tuo documento, specialmente per i progetti più grandi, puoi creare cartelle logiche nella Vista ad albero. Seleziona l'opzione <menuchoice +><guimenu +>Nuovo</guimenu +><guimenuitem +>Cartella</guimenuitem +></menuchoice +> dal menu contestuale delle cartelle predefinite nella Vista ad albero per crearle. Le cartelle possono essere annidate, e puoi spostare gli oggetti trascinandoli da una cartella e sganciandoli in un'altra. </para> + +<screenshot> +<screeninfo +>Organizzare il tuo modello con le cartelle</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="folders.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Organizzare un modello con le cartelle logiche in &umbrello;</phrase> + </textobject> + <caption> + <para +>Organizzare un modello con le cartelle logiche in &umbrello; </para> + </caption> + </mediaobject> +</screenshot> + +</sect2> +</sect1> +</chapter> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/uml_basics.docbook b/tde-i18n-it/docs/tdesdk/umbrello/uml_basics.docbook new file mode 100644 index 00000000000..7ba52ec2f10 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/uml_basics.docbook @@ -0,0 +1,782 @@ +<chapter id="uml-basics"> +<title +>Fondamenti di &UML;</title> +<sect1 id="about-uml"> +<title +>Informazioni su &UML;</title> +<para +>Questo capitolo ti darà una rapida panoramica dei fondamenti di &UML;. Tieni presente che questo non è un corso completo di &UML;, ma piuttosto una breve introduzione a &UML;, che può essere letta come un corso di &UML;. Se vuoi saperne di più sul Linguaggio di Modellazione Unificato, o in generale sull'analisi e la progettazione del software, riferisciti a uno dei molti libri disponibili sull'argomento. Ci sono anche molti corsi su Internet che puoi usare come punto di partenza. </para> + +<para +>Il Linguaggio di Modellazione Unificato (&UML;) è un linguaggio o notazione di diagrammi per specificare, visualizzare e documentare modelli di sistemi di software a oggetti. &UML; non è un metodo di sviluppo, cioè non ti dice cosa fare prima e dopo o come progettare il tuo sistema, ma ti aiuta a visualizzare la tua progettazione e comunicare con gli altri. &UML; è controllato dal Gruppo di Gestione Oggetti (<acronym +>OMG</acronym +>) ed è lo standard industriale per descrivere graficamente il software. </para> +<para +>&UML; è progettato per la progettazione di software a oggetti, e ha un uso limitato per altri paradigmi di programmazione. </para> +<para +>&UML; si compone di molti elementi di modelli che rappresentano le diverse parti di un sistema software. Gli elementi &UML; sono usati per creare diagrammi, che rappresentano una certa parte, o punto di vista del sistema. &umbrello; supporta i seguenti tipi di diagrammi: </para> + +<itemizedlist> + +<listitem +><para +><emphasis +><link linkend="use-case-diagram" +>I diagrammi di caso d'uso</link +></emphasis +> mostrano gli attori (persone o altri utenti del sistema), i casi d'uso (gli scenari di quando usano il sistema), e le loro relazioni</para +> </listitem> + +<listitem +><para +><emphasis +><link linkend="class-diagram" +>I diagrammi di classe</link +></emphasis +> mostrano le classi e le relazioni tra loro</para +> </listitem> + +<listitem +><para +><emphasis +><link linkend="sequence-diagram" +>I diagrammi di sequenza</link +></emphasis +> mostrano gli oggetti e una sequenza di chiamate a metodi che essi fanno ad altri oggetti.</para +> </listitem> + +<listitem +><para +><emphasis +><link linkend="collaboration-diagram" +>I diagrammi di collaborazione</link +></emphasis +> mostrano gli oggetti e le loro relazioni, ponendo l'attenzione sugli oggetti che partecipano nello scambio di messaggi</para> +</listitem> + +<listitem +><para +><emphasis +><link linkend="state-diagram" +>I diagrammi di stato</link +></emphasis +> mostrano gli stati, i cambi di stato e gli eventi in un oggetto o in una parte del sistema</para +> </listitem> + +<listitem +><para +><emphasis +><link linkend="activity-diagram" +>I diagrammi di attività</link +></emphasis +> mostrano le attività e i cambiamenti da un'attività all'altra con gli eventi che accadono in qualche parte del sistema</para +></listitem> + +<listitem +><para +><emphasis +><link linkend="component-diagram" +>I diagrammi dei componenti</link +></emphasis +> mostrano i componenti della programmazione di alto livello (come KPart o Java Beans).</para +></listitem> + +<listitem +><para +><emphasis +><link linkend="deployment-diagram" +>I diagrammi di dispiegamento</link +></emphasis +> mostrano le istanze dei componenti e le loro relazioni.</para +></listitem +> + +</itemizedlist> + +</sect1 +> <!-- about-uml --> + +<sect1 id="uml-elements" +> +<title +>Elementi &UML;</title> +<sect2 id="use-case-diagram"> +<title +>Diagramma di caso d'uso</title> +<para +>I diagrammi di caso d'uso descrivono le relazioni e le dipendenze tra un gruppo di <emphasis +>Casi d'uso</emphasis +> e gli attori partecipanti al processo.</para> +<para +>È importante notare che i diagrammi di caso d'uso non sono adatti a rappresentare la progettazione, e non possono descrivere le parti interne di un sistema. I diagrammi di caso d'uso servono a facilitare la comunicazione con gli utenti futuri del sistema e con il cliente, e sono particolarmente utili a determinare le funzionalità necessarie che il sistema deve avere. I diagrammi di caso d'uso dicono <emphasis +>cosa</emphasis +> deve fare il sistema, ma non specificano <emphasis +>come</emphasis +> si deve fare (e non possono).</para> +<para> +<screenshot> +<screeninfo +>Un esempio di diagramma di caso d'uso.</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="use-case-diagram.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&umbrello; che mostra un diagramma di caso d'uso</phrase> + </textobject> + <caption> + <para +>&umbrello; che mostra un diagramma di caso d'uso </para> + </caption> + </mediaobject> +</screenshot> +</para> +<sect3 id="use-case"> +<title +>Caso d'uso</title> +<para +>Un <emphasis +>Caso d'uso</emphasis +> descrive, dal punto di vista degli attori, un gruppo di attività in un sistema che produce un risultato concreto e tangibile.</para> +<para +>I casi d'uso sono descrizioni delle interazioni tipiche tra gli utenti di un sistema e il sistema stesso. Rappresentano l'interfaccia esterna del sistema, e specificano un modulo di requisiti di cosa il sistema deve fare (ricorda, solo cosa, non come). </para> +<para +>Lavorando con i casi d'uso, è importante ricordare alcune semplici regole: <itemizedlist> + <listitem +><para +>Ogni caso d'uso è relativo ad almeno un attore</para +></listitem> + <listitem +><para +>Ogni caso d'uso ha un iniziatore (&ie; un attore)</para +></listitem> + <listitem +><para +>Ogni caso d'uso porta a un risultato rilevante (un risultato con <quote +>valore di business</quote +>)</para> + </listitem> + </itemizedlist> +</para> +<para +>I casi d'uso possono anche avere relazioni con altri casi d'uso. I tre tipi più comuni di relazioni tra casi d'uso sono:</para> +<itemizedlist> +<listitem +><para +><emphasis +><<inclusione>></emphasis +> che specifica che un caso d'uso avviene <emphasis +>all'interno</emphasis +> di un altro caso d'uso</para +></listitem> +<listitem +><para +><emphasis +><<estensione>></emphasis +> che specifica che in certe situazioni, o a un certo punto (chiamato punto di estensione) un caso d'uso sarà esteso da un altro.</para +></listitem> +<listitem +><para +>La <emphasis +>generalizzazione</emphasis +> specifica che un caso d'uso eredita le caratteristiche del <quote +>sovra</quote +>caso d'uso, e può sostituirne alcune o aggiungerne nuove in un modo simile all'ereditarietà tra classi. </para> +</listitem> +</itemizedlist> +</sect3> +<sect3 id="actor"> +<title +>Attore</title> +<para +>Un attore è un'entità esterna (fuori dal sistema) che interagisce con il sistema partecipando a (e spesso iniziando) un caso d'uso. Gli attori possono essere persone reali (per esempio utenti del sistema), altri sistemi o eventi esterni. </para> +<para +>Gli attori non rappresentano le persone <emphasis +>fisiche</emphasis +> o i sistemi, ma il loro <emphasis +>ruolo</emphasis +>. Ciò significa che quando una persona interagisce con il sistema in modi diversi (assumendo ruoli diversi) sarà rappresentata da diversi attori. Per esempio una persona che fornisce supporto per telefono e immette ordini dal cliente nel sistema sarebbe rappresentato da un attore <quote +>Squadra di supporto</quote +> e un attore <quote +>Rappresentante di vendita</quote +> </para> +</sect3> +<sect3 id="use-case-description"> +<title +>Descrizione di caso d'uso</title> +<para +>Le descrizioni di caso d'uso sono racconti testuali del caso d'uso. Prendono normalmente la forma di una nota o di un documento che è in qualche modo collegato al caso d'uso, e ne spiega i processi o le attività. </para> +</sect3> +</sect2 +> <!-- use-case-diagram --> + +<sect2 id="class-diagram"> +<title +>Diagramma di classe</title> +<para +>I diagrammi di classe mostrano le diverse classi che costituiscono un sistema e come si relazionano una all'altra. I diagrammi di classe sono detti essere diagrammi <quote +>statici</quote +> perché mostrano le classi, insieme ai loro metodi e attributi oltre alle relazioni statiche tra loro: quali classi <quote +>sanno</quote +> di quali classi o quali classi <quote +>fanno parte</quote +> di un'altra classe, ma non mostrano le chiamate ai metodi tra di loro. </para> +<para> +<screenshot> +<screeninfo +>Un esempio di diagramma di classe</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="class-diagram.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&umbrello; che mostra un diagramma di classe</phrase> + </textobject> + <caption> + <para +>&umbrello; che mostra un diagramma di classe </para> + </caption> + </mediaobject> +</screenshot> +</para> +<sect3 id="class"> +<title +>Classe</title> +<para +>Una classe definisce gli attributi e i metodi di un insieme di oggetti. Tutti gli oggetti di questa classe (istanze di questa classe) condividono lo stesso comportamento, e hanno lo stesso insieme di attributi (ogni oggetto ha il suo insieme). A volte il termine <quote +>Tipo</quote +> è usato invece di classe, ma è importante ricordare che questi due non sono la stessa cosa, e Tipo è un termine più generale. </para> +<para +>In &UML; le classi sono rappresentate da rettangoli con il nome della classe, e possono anche mostrare gli attributi e le operazioni della classe in due altri <quote +>scompartimenti</quote +> all'interno del rettangolo. </para> +<para> +<screenshot> +<screeninfo +>Una classe in &UML;</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="class.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Rappresentazione visiva di una classe in &UML;</phrase> + </textobject> + <caption> + <para +>Rappresentazione visiva di una classe in &UML; </para> + </caption> + </mediaobject> +</screenshot> +</para> +<sect4 id="attribute"> +<title +>Attributi</title> +<para +>In &UML; gli attributi sono mostrati con almeno il loro nome, e possono mostrare anche il loro tipo, il valore iniziale e altre proprietà. Gli attributi possono anche essere mostrati con la loro visibilità: </para> +<itemizedlist> +<listitem +><para +><literal +>+</literal +> sta per attributi <emphasis +>pubblici</emphasis +></para +></listitem> +<listitem +><para +><literal +>#</literal +> sta per attributi <emphasis +>protetti</emphasis +></para +></listitem> +<listitem +><para +><literal +>-</literal +> sta per attributi <emphasis +>privati</emphasis +></para +></listitem> +</itemizedlist> +</sect4> +<sect4 id="operation"> +<title +>Operazioni</title> +<para +>Anche le operazioni (metodi) sono mostrate con almeno il loro nome, e possono mostrare anche i loro parametri e i tipi restituiti. Le operazioni possono, come gli attributi, mostrare la loro visibilità: <itemizedlist> +<listitem +><para +><literal +>+</literal +> sta per operazioni <emphasis +>pubbliche</emphasis +></para +></listitem> +<listitem +><para +><literal +>#</literal +> sta per operazioni <emphasis +>protette</emphasis +></para +></listitem> +<listitem +><para +><literal +>-</literal +> sta per operazioni <emphasis +>private</emphasis +></para +></listitem> +</itemizedlist> +</para> +</sect4> + +<sect4 id="templates"> +<title +>Modelli</title> +<para +>Le classi possono avere modelli, un valore che è usato per una classe o untipo non specificato. Il tipo di modello è specificato quando viene iniziata una classe (&ie; cioè viene creato un oggetto). I modelli esistono nel C++ moderno e saranno introdotti in Java 1.5 dove saranno chiamati Generics. </para> +</sect4> +</sect3> + +<sect3 id="class-associations"> +<title +>Associazioni di classi</title> +<para +>Le classi possono relazionarsi (essere associate) una con l'altra in diversi modi:</para> +<sect4 id="generalization"> +<title +>Generalizzazione</title> +<para +>L'ereditarietà è uno dei concetti fondamentali della programmazione a oggetti, in cui una classe <quote +>acquisisce</quote +> tutti gli attributi e le operazioni della classe da cui eredita, e può sostituire o modificare alcuni di loro, oltre ad aggiungere più attributi e operazioni di suo.</para> +<para +>In &UML;, un'associazione di <emphasis +>Generalizzazione</emphasis +> tra due classi le mette in una gerarchia rappresentante il concetto di ereditarietà di una classe derivata da una classe di base. In &UML; le generalizzazioni sono rappresentate da una linea che connette le due classi, con una freccia sul lato della classe di base. <screenshot> +<screeninfo +>Generalizzazione</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="generalization.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Rappresentazione visiva di una generalizzazione in &UML;</phrase> + </textobject> + <caption> + <para +>Rappresentazione visiva di una generalizzazione in &UML; </para> + </caption> + </mediaobject> +</screenshot> +</para> +</sect4> + +<sect4 id="uml-associations"> +<title +>Associazioni</title> +<para +>Un'associazione rappresenta una relazione tra classi, e dà la semantica e la struttura comuni a molti tipi di <quote +>connessioni</quote +> tra oggetti.</para> +<para +>Le associazioni sono i meccanismi che permettono agli oggetti di comunicare tra loro. Descrivono la connessione tra diverse classi (la connessione tra gli oggetti reali è chiamata una connessione tra oggetti, o <emphasis +>collegamento</emphasis +>). </para> +<para +>Le associazioni possono avere un ruolo che specifica lo scopo dell'associazione e può essere uni- o bidirezionale (indica se i due oggetti che partecipano alla relazione possono mandare messaggi all'altro, o se solo uno di loro sa dell'altro). Ogni parte dell'associazione ha un valore di molteplicità, che detta quanti oggetti su questo lato dell'associazione possono relazionarsi a un oggetto sull'altro lato. </para> +<para +>In &UML; le associazioni sono rappresentate come linee che connettono le classi che partecipano alla relazione, e possono anche mostrare il ruolo e la molteplicità di ciascuno dei partecipanti. La molteplicità è mostrata come un intervallo [minimo..massimo] di valori non negativi, con un asterisco (<literal +>*</literal +>) sul lato massimo per rappresentare l'infinito. <screenshot> +<screeninfo +>Associazione &UML;</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="association.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Rappresentazione visiva di un'associazione in &UML;</phrase> + </textobject> + <caption> + <para +>Rappresentazione visiva di un'associazione in &UML; </para> + </caption> + </mediaobject> +</screenshot> +</para> +</sect4> + +<sect4 id="aggregation"> +<title +>Aggregazione</title> +<para +>Le aggregazioni sono un tipo speciale di associazioni nel quale le due classi partecipanti non hanno un rango uguale, ma hanno una relazione <quote +>intero-parte</quote +>. Un'aggregazione descrive come la classe che ha il ruolo dell'intero è composta di (ha) altre classi, che hanno il ruolo di parti. Per le aggregazioni, la classe che fa da intero ha sempre molteplicità di uno. </para> +<para +>In &UML; le aggregazioni sono rappresentate da un'associazione che mostra un rombo sul lato dell'intero. <screenshot> +<screeninfo +>Aggregazione</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="aggregation.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Rappresentazione visiva di una relazione di aggregazione in &UML;</phrase> + </textobject> + <caption> + <para +>Rappresentazione visiva di una relazione di aggregazione in &UML; </para> + </caption> + </mediaobject> +</screenshot> +</para> +</sect4> +<sect4 id="composition"> +<title +>Composizione</title> +<para +>Le composizioni sono associazioni che rappresentano aggregazioni <emphasis +>molto forti</emphasis +>. Ciò vuol dire che anche le composizioni formano relazioni intero-parte, ma la relazione è così forte che la parte non può esistere di per sé. Esistono solo all'interno dell'intero, e se l'intero è distrutto anche le parti muoiono.</para> +<para +>In &UML; le composizioni sono rappresentate da un rombo solido sul lato dell'intero. </para> +<para +><screenshot> +<screeninfo +>Composizione</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="composition.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Rappresentazione visiva di una relazione di composizione in &UML;</phrase> + </textobject> + </mediaobject> +</screenshot +></para> +</sect4> +</sect3 +> <!--class-associations--> + +<sect3 id="other-class-diagram-items"> +<title +>Altri elementi dei diagrammi di classe</title> +<para +>I diagrammi di classe possono contenere diversi altri elementi oltre alle classi.</para> +<sect4 id="interfaces"> +<title +>Interfacce</title> +<para +>Le interfacce sono classi astratte, che vuol dire che non se ne possono creare istanze direttamente. Possono contenere operazioni ma non attributi. Le classi possono ereditare dalle interfacce (attraverso una associazione di realizzazione) e possono essere create delle istanze di questi diagrammi.</para> +<!-- FIXME screenshot --> +</sect4> +<sect4 id="datatype"> +<title +>Tipi di dati</title> +<para +>I tipi di dati sono delle primitive tipicamente incorporate in un linguaggio di programmazione. Gli esempi comuni includono gli interi e i booleani. Non possono avere relazioni con le classi, ma le classi possono avere relazioni con loro.</para> +<!-- FIXME screenshot --> +</sect4> +<sect4 id="enum"> +<title +>Enumerazioni</title> +<para +>Le enumerazioni sono semplici elenchi di valori. Un esempio tipico è un'enumerazione dei giorni della settimana. Le opzioni di un'enumerazione sono chiamate letterali dell'enumerazione. Come i tipi di dati non possono avere relazioni con le classi, ma le classi possono avere relazioni con loro.</para> +<!-- FIXME screenshot --> +</sect4> +<sect4 id="package"> +<title +>Pacchetti</title> +<para +>I pacchetti rappresentano un namespace in un linguaggio di programmazione. In un diagramma sono usati per rappresentare parti di un sistema che contiene più di una classe, forse centinaia di classi.</para> +<!-- FIXME screenshot --> +</sect4> +</sect3> + +</sect2 +> <!-- class diagram --> + +<sect2 id="sequence-diagram"> +<title +>Diagrammi di sequenza</title> + +<para +>I diagrammi di sequenza mostrano lo scambio di messaggi (&ie; la chiamata ai metodi) tra diversi oggetti in una situazione temporale precisa. Gli oggetti sono istanze di classi. I diagrammi di sequenza mettono particolare enfasi sull'ordine e l'ora a cui i messaggi sono inviati agli oggetti.</para> + +<para +>Nei diagrammi di sequenza gli oggetti sono rappresentati con linee verticali tratteggiate, con il nome dell'oggetto in cima. Anche l'asse temporale è verticale, e aumenta andando in giù, in modo che i messaggi sono inviati da un oggetto all'altro nella forma di frecce con l'operazione e il nome del parametro. </para> + +<!-- FIXME update screenshot to show synchronous messages --> +<screenshot> +<screeninfo +>Diagramma di sequenza</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="sequence-diagram.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&umbrello; che mostra un diagramma di sequenza</phrase> + </textobject> + <caption> + <para +>&umbrello; che mostra un diagramma di sequenza </para> + </caption> + </mediaobject> +</screenshot> + +<para +>I messaggi possono o essere sincroni, il tipo normale di chiamate ai messaggi dove il controllo è passato all'oggetto chiamato fino a quando quel metodo ha finito l'esecuzione, o asincrono, dove il controllo è ripassato direttamente all'oggetto chiamante. I messaggi sincroni hanno un riquadro verticale a lato dell'oggetto chiamato per mostrare il flusso di controllo del programma.</para> +</sect2 +> <!-- sequence diagrams --> + +<sect2 id="collaboration-diagram"> +<title +>Diagrammi di collaborazione</title> + +<para +>I diagrammi di collaborazione mostrano le interazioni che avvengono tra gli oggetti che partecipano a una situazione specifica. È più o meno la stessa informazione mostrata nei diagrammi di sequenza, ma lì l'enfasi è messa su come le interazioni avvengono nel tempo, mentre i diagrammi di collaborazione mettono in primo piano le relazioni tra gli oggetti e la loro topologia.</para> + +<para +>Nei diagrammi di collaborazione i messaggi inviati da un oggetto a un altro sono rappresentati da frecce, che mostrano il nome, i parametri e la sequenza del messaggio. I diagrammi di collaborazione sono specialmente adatti a mostrare un particolare flusso o situazione di programma e sono uno dei migliori tipi di diagramma per dimostrare o spiegare rapidamente un processo nella logica del programma. </para> + +<screenshot> +<screeninfo +>Collaborazione</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="collaboration-diagram.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&umbrello; che mostra un diagramma di collaborazione</phrase> + </textobject> + <caption> + <para +>&umbrello; che mostra un diagramma di collaborazione </para> + </caption> + </mediaobject> +</screenshot> + +</sect2 +> <!-- collaboration diagrams --> + +<sect2 id="state-diagram"> +<title +>Diagramma di stato</title> +<para +>I diagrammi di stato mostrano i diversi stati di un oggetto durante la sua vita e gli stimoli che gli fatto cambiare stato. </para +> +<para +>I diagrammi di stato vedono gli oggetti come <emphasis +>macchine di stato</emphasis +> o automi finiti che possono essere in uno stato di un insieme di stati finiti e che possono cambiare stato con uno stimolo di un insieme finito di stimoli. Per esempio un oggetto di tipo <emphasis +>ServerDiRete</emphasis +> può essere in uno dei seguenti stati durante la sua vita: </para> +<itemizedlist> +<listitem +><para +>Pronto</para +></listitem> +<listitem +><para +>In ascolto</para +></listitem> +<listitem +><para +>Attivo</para +></listitem> +<listitem +><para +>Fermato</para +></listitem> +</itemizedlist> +<para +>e gli eventi che possono far cambiare stato all'oggetto sono</para> +<itemizedlist> +<listitem +><para +>L'oggetto è creato</para +></listitem> +<listitem +><para +>L'oggetto riceve il messaggio di ascolto</para +></listitem> +<listitem +><para +>Un client richiede una connessione sulla rete</para +></listitem> +<listitem +><para +>Un client termina una richiesta</para +></listitem> +<listitem +><para +>La richiesta è eseguita e conclusa</para +></listitem> +<listitem +><para +>L'oggetto riceve un messaggio di fermata</para +></listitem> +<listitem +><para +>ecc.</para +></listitem> +</itemizedlist> +<para> +<screenshot> +<screeninfo +>Diagramma di stato</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="state-diagram.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&umbrello; che mostra un diagramma di stato</phrase> + </textobject> + <caption> + <para +>&umbrello; che mostra un diagramma di stato </para> + </caption> + </mediaobject> +</screenshot> +</para> +<sect3 id="state"> +<title +>Stato</title> +<para +>Gli stati sono i mattoni del diagramma di stato. Uno stato appartiene a esattamente una classe e rappresenta un riassunto dei valori che gli attributi di una classe possono assumere. Uno stato &UML; descrive lo stato interno di un oggetto di una classe particolare </para +> +<para +>Nota che non tutti i cambiamenti negli attributi di un oggetto dovrebbe essere rappresentato da uno stato, ma solo quei cambiamenti che influenzano significativamente il funzionamento dell'oggetto</para> +<para +>Ci sono due tipi speciali di stati: Inizio e Fine. Sono speciali perché non ci sono eventi che possono far tornare un oggetto al suo stato di Inizio, allo stesso modo in cui non è possibile riportare un oggetto dal suo stato di Fine una volta che lo raggiunge. </para> +</sect3> + +</sect2 +> <!-- state diagrams --> + +<sect2 id="activity-diagram"> +<title +>Diagrammi di attività</title> +<para +>I diagrammi di attività descrivono la sequenza di attività in un sistema con l'aiuto delle attività. I diagrammi di attività sono una forma speciale dei diagrammi di stato, che contengono solo (o per lo più) attività. </para> +<para> +<screenshot> +<screeninfo +>Un esempio di diagramma di attività.</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="activity-diagram.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&umbrello; che mostra un diagramma di attività</phrase> + </textobject> + <caption> + <para +>&umbrello; che mostra un diagramma di attività </para> + </caption> + </mediaobject> +</screenshot> +</para> +<para +>I diagrammi di attività sono simili ai diagrammi di flusso procedurali, con la differenza che tutte le attività sono chiaramente connesse a degli oggetti.</para> + +<para +>I diagrammi di attività sono sempre associati a una <emphasis +>classe</emphasis +>, un'<emphasis +>operazione</emphasis +> o un <emphasis +>caso d'uso</emphasis +>.</para> + +<para +>I diagrammi di attività supportano attività sequenziali e parallele. L'esecuzione parallela è rappresentata con le icone Separa/Attendi; per le attività in esecuzione in parallelo, non è importante l'ordine in cui sono eseguite (possono essere eseguite allo stesso tempo o una dopo l'altra)</para> +<sect3 id="activity"> +<title +>Attività</title> +<para +>Un'attività è un singolo passo in un processo. Un'attività è uno stato del sistema con attività interna e, almeno, una transizione all'esterno. Le attività possono anche avere più di una transizione all'esterno se hanno più condizioni. </para +> +<para +>Le attività possono formare gerarchie, vale a dire che un'attività può essere composta di più attività di <quote +>dettaglio</quote +>, nel qual caso le transizioni all'interno e all'esterno dovrebbero corrispondere alle transizioni all'interno e all'esterno del diagramma dei dettagli. </para> + +</sect3> +</sect2 +> <!-- activity diagram --> + +<sect2 id="helper-elements"> +<title +>Elementi ausiliari</title> +<para +>Ci sono alcuni elementi in &UML; che non hanno una vera e propria semantica per il modello, ma aiutano a chiarificare parti del diagramma. Questi elementi sono </para> +<itemizedlist> +<listitem +><para +>Righe di testo</para +></listitem> +<listitem +><para +>Note di testo e ancore</para +></listitem> +<listitem +><para +>Riquadri</para +></listitem> +</itemizedlist +> +<para +>Le righe di testo sono utili per aggiungere brevi informazioni testuali a un diagramma. È testo libero e non ha significato per il modello stesso. </para +> + +<para +>Le note sono utili per aggiungere informazioni più dettagliate su un oggetto o una situazione specifica. Hanno il grande vantaggio che le note possono essere ancorate a elementi &UML; per mostrare che la nota <quote +>appartiene</quote +> a un oggetto o una situazione specifici. </para> + +<para +>I riquadri sono rettangoli liberi che possono essere usati per raggruppare insieme degli elementi per rendere i diagrammi più leggibili. Non hanno nessun significato logico nel modello.</para> + +<!-- FIXME, screenshot --> +</sect2 +> <!-- helper elements --> + +<sect2 id="component-diagram"> +<title +>Diagrammi dei componenti</title> +<para +>I diagrammi dei componenti mostrano i componenti software (tecnologie componenti come KPart, componenti CORBA, Java Beans o solo sezioni del sistema che sono chiaramente distinguibili) e i manufatti di cui sono fatti come file di codice sorgente, librerie di programmazione o tabelle di banche dati relazionali.</para> + +<para +>I componenti possono avere interfacce (&ie; classi astratte con operazioni) che permettono associazioni tra componenti.</para> +</sect2> + +<sect2 id="deployment-diagram"> +<title +>Diagrammi di dispiegamento</title> + +<para +>I diagrammi di dispiegamento mostrano le istanze dei componenti durante l'esecuzione e le loro associazioni. Includono i nodi, che sono risorse fisiche, tipicamente un computer singolo. Mostrano anche interfacce e oggetti (istanze di classi).</para> + +</sect2> + +</sect1 +> +</chapter> diff --git a/tde-i18n-it/docs/tdesdk/umbrello/working_with_umbrello.docbook b/tde-i18n-it/docs/tdesdk/umbrello/working_with_umbrello.docbook new file mode 100644 index 00000000000..3643c11e322 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/umbrello/working_with_umbrello.docbook @@ -0,0 +1,413 @@ +<chapter id="working-with-umbrello"> +<title +>Lavorare con &umbrello;</title> +<!-- Umbrello basics: creating diagrams, creating classes, adding objects to diagrams, + associations, editing properties, anchor points in associations, removing objects, removing + diagrams +--> + +<para +>Questo capitolo ti introdurrà all'interfaccia utente di &umbrello; e ti dirà tutto quello di cui hai bisogno per iniziare a modellare. Tutte le azioni in &umbrello; sono accessibili attraverso il menu e le barre degli strumenti, ma &umbrello; usa molto anche i menu contestuali del &RMB;. Puoi fare clic con il &RMB; su quasi ogni elemento nell'area di lavoro di &umbrello; o nella vista ad albero, per ottenere un menu con le funzioni più utili che possono essere applicate al particolare elemento su cui stai lavorando. Alcuni utenti si sentono un po' confusi all'inizio perché sono abituati a lavorare con il menu o le barre degli strumenti, ma una volta che ti abitui a fare clic con il pulsante <mousebutton +>destro</mousebutton +> il tuo lavoro sarà molto più veloce. </para> + +<sect1 id="user-interface"> +<title +>Interfaccia utente</title> +<para +>La finestra principale di &umbrello; è divisa in tre aree che ti aiuteranno a mantenere una panoramica del tuo intero sistema e ad accedere rapidamente ai diversi diagrammi mentre lavori sul tuo modello. </para> +<para +>Queste aree sono chiamate:</para> +<itemizedlist> +<listitem +><para +>Vista ad albero</para +></listitem> +<listitem +><para +>Area di lavoro</para +></listitem> +<listitem +><para +>Finestra di documentazione</para +></listitem> +</itemizedlist> + +<screenshot> +<screeninfo +>L'interfaccia utente di &umbrello;</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="umbrello-ui.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>L'interfaccia utente di &umbrello;</phrase> + </textobject> + <caption> + <para +>L'interfaccia utente di &umbrello; </para> + </caption> + </mediaobject> +</screenshot> + +<sect2 id="tree-view"> +<title +>Vista ad albero</title> +<para +>La Vista ad albero è normalmente situata all'angolo in alto a sinistra della finestra, e mostra tutti i diagrammi, le classi, gli attori e i casi d'uso che costituiscono il tuo modello. La Vista ad albero ti permette di avere una semplice panoramica degli elementi che compongono il tuo modello. La Vista ad albero ti dà anche un modo semplice per spostarti tra i diversi diagrammi del tuo modello, e inserire elementi dal tuo modello nel diagramma attuale. </para> +<para +>Se stai lavorando a un modello con più che poche classi e diagrammi, la Vista ad albero ti può anche aiutare a orientarti organizzando il tuo modello nelle cartelle. Puoi creare delle cartelle selezionando l'opzione apposita dal menu contestuale (fai clic con il &RMB; su una delle cartelle nella vista ad albero), e puoi organizzare i tuoi elementi spostandoli alla cartella giusta (trascinandoli) </para> +</sect2> + +<sect2 id="documentation-window"> +<title +>Finestra di documentazione</title> +<para +>La Finestra di documentazione è la piccola finestra situata nell'angolo in basso a sinistra di &umbrello;, e ti dà una rapida anteprima della documentazione dell'elemento attualmente selezionato. La Finestra di documentazione è piuttosto piccola perché dovrebbe permetterti di dare solo un'occhiata alla documentazione di un elemento, occupando meno spazio possibile. Se devi vedere la documentazione in maggior dettaglio, puoi sempre aprire le proprietà dell'elemento. </para> +</sect2> +<sect2 id="work-area"> +<title +>Area di lavoro</title> +<para +>L'Area di lavoro è la finestra principale di &umbrello; ed è dove avviene il lavoro vero e proprio. Si usa l'Area di lavoro per modificare e visualizzare i diagrammi del tuo modello. L'Area di lavoro mostra il diagramma attualmente attivo. Attualmente si può vedere solo un diagramma alla volta. </para> +</sect2> +</sect1 +> <!--user-interface--> +<sect1 id="load-save"> +<title +>Creare, caricare e salvare i modelli</title> +<para +>La prima cosa che devi fare per iniziare a fare qualcosa di utile con &umbrello; è creare un modello su cui lavorare. Quando lo avvii, &umbrello; carica sempre l'ultimo modello usato o ne crea uno nuovo vuoto (a seconda delle tue preferenze come impostate nella finestra di configurazione). Ciò ti permetterà di iniziare subito a lavorare. </para> +<sect2 id="new-model"> +<title +>Nuovo modello</title> +<para +>Se in qualsiasi momento dovessi creare un nuovo modello, puoi farlo selezionando la voce <guimenuitem +>Nuovo</guimenuitem +> nel menu <guimenu +>File</guimenu +>, o facendo clic sull'icona <guiicon +>Nuovo</guiicon +> dalla barra delle applicazioni. Se al momento stai lavorando su un modello che è stato modificato, &umbrello; ti chiederà se deve salvare le tue modifiche prima di caricare il nuovo modello. </para> +</sect2> +<sect2 id="save-model"> +<title +>Salva modello</title> +<para +>Puoi salvare il tuo modello in qualsiasi momento selezionando l'opzione <guimenuitem +>Salva</guimenuitem +> nel menu <guimenu +>File</guimenu +>, o facendo clic sull'icona <guiicon +>Salva</guiicon +> nella barra delle applicazioni. Se devi salvare il tuo modello con un nome diverso puoi usare l'opzione <guimenuitem +>Salva con nome</guimenuitem +> nel menu <guimenu +>File</guimenu +>. </para> +<para +>Per la tua comodità &umbrello; ti offre anche l'opzione di salvare automaticamente il tuo lavoro a intervalli regolari. Puoi configurare se vuoi questa opzione, e anche l'intervallo di tempo, nelle <guimenu +>Impostazioni</guimenu +> di &umbrello;</para> +</sect2> +<sect2 id="load-model"> +<title +>Carica modello</title> +<para +>Per caricare un modello preesistente puoi selezionare l'opzione <guimenuitem +>Apri</guimenuitem +> nel menu <guimenu +>File</guimenu +> o fare clic sull'icona <guiicon +>Apri</guiicon +> nella barra delle applicazioni. I modelli più recentemente usati sono disponibili anche nel sottomenu <guimenuitem +>Apri recenti</guimenuitem +> nel menu <guimenu +>File</guimenu +> per facilitare l'accesso ai modelli che usi più spesso. </para> +<para +>&umbrello; può lavorare solo su un modello alla volta, quindi se chiedi al programma di caricarti un modello e il tuo modello è stato modificato dall'ultima volta che l'hai salvato, &umbrello; ti chiederà se le tue modifiche debbano essere salvate per evitare qualsiasi perdita di lavoro. Puoi avviare due o più istanze di &umbrello; in qualsiasi momento, e puoi anche copiare e incollare tra le istanze. </para> +</sect2> +</sect1 +> <!--load-save--> +<sect1 id="edit-model"> +<title +>Modificare i modelli</title> +<para +>In &umbrello; ci sono fondamentalmente due modi per modificare gli elementi del tuo modello. <itemizedlist> +<listitem +><para +>Modificare gli elementi del modello direttamente attraverso la Vista ad albero</para +></listitem> +<listitem +><para +>Modificare gli elementi del modello attraverso un diagramma</para +></listitem> +</itemizedlist> +</para> +<para +>Usando il menu contestuale dei diversi elementi nella Vista ad albero puoi aggiungere, rimuovere e modificare quasi tutti gli elementi nel tuo modello. Fare clic <mousebutton +>destro</mousebutton +> sulle cartelle nella Vista ad albero ti darà le opzioni per creare i diversi tipi di diagrammi e anche, a seconda che la cartella sia una <emphasis +>Vista dei casi d'uso</emphasis +> o una <emphasis +>Vista logica</emphasis +>, attori, casi d'uso, classi ecc. </para> +<para +>Una volta che hai aggiunto gli elementi nel tuo modello, puoi anche modificarli accedendo alle loro finestre delle proprietà, che puoi trovare selezionando l'opzione <emphasis +>Proprietà</emphasis +> dal menu contestuale mostrato quando fai clic <mousebutton +>destro</mousebutton +> sugli elementi nella Vista ad albero. </para> +<para +>Puoi anche modificare il tuo modello creando o modificando degli elementi per mezzo dei diagrammi. Maggiori dettagli su come farlo sono dati nelle sezioni successive. </para> +</sect1> +<sect1 id="add-remove-diagrams"> +<title +>Aggiungere e rimuovere i diagrammi</title> +<para +>Il tuo modello &UML; consiste di un insieme di elementi &UML; e associazioni tra di loro. Tuttavia non puoi vedere il modello direttamente, ma usi dei <emphasis +>diagrammi</emphasis +> per vederlo. </para> +<sect2 id="create-diagram"> +<title +>Creare i diagrammi</title> +<para +>Per creare un nuovo diagramma nel tuo modello, seleziona semplicemente il tipo di diagramma di cui hai bisogno dal sottomenu <guimenuitem +>Nuovo</guimenuitem +> nel menu <guimenu +>Diagramma</guimenu +> e dàgli un nome. Il diagramma sarà creato e attivato, e potrai immediatamente vederlo nella Vista ad albero. </para> +<para +>Ricorda che &umbrello; fa ampio uso dei menu contestuali: puoi anche fare clic con il &RMB; su una cartella nella Vista ad albero e selezionare il tipo appropriato di diagramma dal sottomenu <guisubmenu +>Nuovo</guisubmenu +> nel menu contestuale. Nota che puoi creare diagrammi di casi d'uso solo nelle cartelle di Vista dei casi d'uso, e gli altri tipi di diagrammi solo nelle cartelle di Vista logica. </para> +</sect2> +<sect2 id="remove-diagram"> +<title +>Rimuovere i diagrammi</title> +<para +>Se dovessi rimuovere un diagramma dal tuo modello, puoi farlo attivandolo e selezionando <guimenuitem +>Elimina</guimenuitem +> dal menu <guimenu +>Diagramma</guimenu +>. Puoi anche farlo selezionando <guimenuitem +>Elimina</guimenuitem +> dal menu contestuale del diagramma nella Vista ad albero </para> +<para +>Siccome eliminare un diagramma è qualcosa di serio che potrebbe causare perdite di lavoro se fatto per sbaglio, &umbrello; ti chiederà di confermare l'operazione di eliminazione prima di rimuovere per davvero il diagramma. Una volta che un diagramma è stato eliminato e il file salvato, non c'è modo di annullare questa azione. </para> +</sect2> +<sect2 id="rename-diagram"> +<title +>Rinominare i diagrammi</title> +<para +>Se vuoi cambiare il nome di un diagramma esistente puoi farlo facilmente selezionando l'opzione Rinomina dal suo menu del &RMB; nella vista ad albero. </para> +<para +>Un altro modo di rinominare un diagramma è farlo dalla sua finestra delle proprietà, che ottieni selezionando Proprietà dal suo menu contestuale o facendoci doppio clic nella Vista ad albero. </para> +</sect2> +</sect1> +<sect1 id="edit-diagram"> +<title +>Modificare i diagrammi</title> +<para +>Quando si lavora su un diagramma, &umbrello; cercherà di guidarti applicando alcune semplici regole, come quali elementi sono validi nei diversi tipi di diagrammi, e anche le relazioni che possono esistere tra di loro. Se sei un esperto di &UML; probabilmente non lo noterai nemmeno, ma questo aiuterà i novellini di &UML; a creare dei diagrammi conformi agli standard. </para> +<para +>Una volta che hai creato i tuoi diagrammi è ora di iniziare a modificarli. Qui dovresti notare la differenza (sottile per i novellini) tra modificare il tuo diagramma, e modificare il <emphasis +>modello</emphasis +>. Come già saprai, i diagrammi sono <emphasis +>visualizzazioni</emphasis +> del tuo modello. Per esempio, se crei una classe modificando un diagramma di classe, stai in realtà modificando sia il tuo diagramma che il tuo modello. Se cambi il colore o un'altra opzione di visualizzazione di una classe nel tuo diagramma di classe, stai solo modificando il diagramma, ma non cambia nulla nel tuo modello. </para> +<sect2 id="insert-elements"> +<title +>Inserire gli elementi</title> +<para +>Una delle prime cose che vorrai fare modificando un nuovo diagramma è inserirci elementi (classi, attori, casi d'uso, &etc;). Ci sono fondamentalmente due modi per farlo:</para> +<itemizedlist> +<listitem +><para +>Trascinare gli elementi esistenti nel tuo modello dalla Vista ad albero</para +></listitem> +<listitem +><para +>Creare i nuovi elementi nel tuo modello e aggiungerli ai tuoi diagrammi allo stesso tempo, usando uno degli strumenti di modifica nella barra degli strumenti di lavoro</para +></listitem> +</itemizedlist> +<para +>Per inserire gli elementi che esistono già nel tuo modello, trascinali dalla Vista ad albero e sganciali dove vuoi che stiano nel tuo diagramma. Puoi sempre spostare gli elementi nel tuo diagramma usando lo strumento Seleziona </para> +<para +>Il secondo modo di aggiungere elementi al tuo diagramma è usare gli strumenti di modifica della barra degli strumenti di lavoro (nota che, inoltre, ciò aggiungerà gli elementi al tuo modello). </para> +<para +>La barra degli strumenti di lavoro, come impostazione predefinita, era posizionata in fondo a destra della finestra dell'applicazione; &umbrello; 1.2 l'ha spostata in cima alla finestra. Puoi agganciarla a un altro bordo o spostarla in giro, se preferisci. Gli strumenti disponibili in questa barra degli strumenti (i pulsanti che ci vedi sopra) cambiano a seconda del tipo di diagramma su cui stai lavorando attualmente. Il pulsante per lo strumento attualmente selezionato è attivato nella barra degli strumenti. Puoi passare allo strumento di selezione premendo il tasto &Esc;. </para> +<para +>Quando hai selezionato uno strumento di modifica nella barra degli strumenti di lavoro (per esempio, lo strumento per inserire le classi) il puntatore del mouse diventa una croce, e puoi inserire gli elementi nel tuo modello facendo un solo clic nel tuo diagramma. Nota che gli elementi in &UML; devono avere un <emphasis +>nome univoco</emphasis +>. Quindi, se hai una classe in un diagramma che si chiama <quote +>ClasseA</quote +>, e usi lo strumento di inserimento classi per inserire una classe in un altro diagramma, non puoi chiamare anche questa nuova classe <quote +>ClasseA</quote +>. Se queste due devono essere elementi diversi, devi dargli dei nomi univoci. Se stai cercando di aggiungere lo <emphasis +>stesso</emphasis +> elemento al tuo diagramma, Inserisci classe non è lo strumento giusto. Dovresti invece trascinare la classe dalla Vista ad albero. </para> +</sect2> +<sect2 id="delete-elements"> +<title +>Eliminare gli elementi</title> +<para +>Puoi eliminare qualsiasi elemento selezionando l'opzione <guimenuitem +>Elimina</guimenuitem +> dal suo menu contestuale. </para> +<para +>Di nuovo, c'è una <emphasis +>grossa</emphasis +> differenza tra rimuovere un oggetto da un diagramma, ed eliminare un oggetto dal tuo modello: se elimini un oggetto da un diagramma, stai solo rimuovendo l'oggetto da quel diagramma particolare: l'elemento sarà ancora parte del tuo modello, e se ci sono altri diagrammi che usano lo stesso elemento, non subiranno conseguenze. Se, d'altro canto, elimini l'elemento dalla Vista ad albero, stai effettivamente eliminando l'elemento dal tuo <emphasis +>modello</emphasis +>. Siccome l'elemento non esiste più nel tuo modello, sarà automaticamente rimosso da tutti i diagrammi in cui appare. </para> +</sect2> +<sect2 id="edit-elements"> +<title +>Modificare gli elementi</title> +<para +>Puoi modificare la maggior parte degli elementi e dei diagrammi &UML; aprendo le loro finestre delle Proprietà e selezionando le opzioni appropriate. Per modificare le proprietà di un oggetto, seleziona <guimenuitem +>Proprietà</guimenuitem +> dal suo menu contestuale (fai clic con il &RMB;). Ogni elemento ha una finestra di dialogo consistente in diverse pagine dove puoi configurare le opzioni corrispondenti a quell'elemento. Per alcuni elementi, come gli attori, puoi impostare solo un paio di opzioni, come il nome e la documentazione dell'oggetto, mentre per altri elementi, come le classi, puoi modificare gli attributi e le operazioni, selezionare cosa vuoi sia mostrato nel diagramma (la firma completa delle operazioni o solo i nomi delle operazioni, ecc.) e anche i colori che vuoi usare per la linea e per il riempimento della rappresentazione della classe nel diagramma. </para> + +<para +>Per la maggior parte degli elementi &UML; puoi anche aprire la finestra delle proprietà facendoci doppio clic se stai usando lo strumento di selezione (freccia). L'eccezione alla regola sono le Associazioni, nel qual caso un doppio clic creerà un punto di ancoraggio. Per le associazioni devi usare il menu contestuale del &RMB; per ottenere la finestra delle proprietà. </para> + +<para +>Nota che puoi anche selezionare le opzioni delle proprietà dal menu contestuale degli elementi nella vista ad albero. Ciò ti permette anche di modificare le proprietà dei diagrammi, come impostare se la griglia debba essere mostrata o meno. </para> +</sect2> +<sect2 id="edit-classes"> +<title +>Modificare le classi</title> +<para +>Anche se è stato già descritto come modificare le proprietà di tutti gli oggetti nella sezione precedente, le classi meritano una sezione speciale perché sono un po' più complicate e hanno più opzioni della maggior parte degli altri elementi &UML;. </para> +<para +>Nella finestra delle proprietà di una classe puoi impostare tutto, dal colore usato alle operazioni e attributi che ha. </para> +<sect3 id="class-general-settings"> +<title +>Impostazioni generali delle classi</title> +<para +>La pagina Impostazioni generali della finestra delle proprietà si spiega da sé. Qui puoi cambiare il nome della classe, la visibilità, la documentazione, &etc; Questa pagina è sempre disponibile. </para> +</sect3> +<sect3 id="class-attributes-settings"> +<title +>Impostazione degli attributi delle classi</title> +<para +>Nella pagina Attributi delle classi puoi aggiungere, modificare o eliminare gli attributi (le variabili) della classe. Puoi spostare gli attributi in su e in giù nell'elenco premendo il pulsante a freccia di fianco. Questa pagina è sempre disponibile. </para> +</sect3> +<sect3 id="class-operations-settings"> +<title +>Impostazioni delle operazioni delle classi</title> +<para +>In modo simile alla pagina delle Impostazioni degli attributi, nella pagina delle Impostazioni delle operazioni puoi aggiungere, modificare o rimuovere le operazioni della tua classe. Quando aggiungi o modifichi un'operazione, inserisci i dati di base nella finestra <emphasis +>Proprietà delle operazioni</emphasis +>. Se vuoi aggiungere dei parametri alle tue operazioni devi fare clic sul pulsante <guibutton +>Nuovo parametro</guibutton +>, che mostrerà la finestra <emphasis +>Proprietà del parametro</emphasis +>. Questa pagina è sempre disponibile </para> +</sect3> +<sect3 id="class-template-settings"> +<title +>Impostazioni dei modelli delle classi</title> +<para +>Questa pagina ti permette di aggiungere modelli di classi, che sono classi o tipi di dati non specificati. In Java 1.5 saranno chiamati Generics. </para> +</sect3> +<sect3 id="class-associations-page"> +<title +>Pagina delle associazioni delle classi</title> +<para +>La pagina <guilabel +>Associazioni della classe</guilabel +> mostra tutte le associazioni di questa classe nel diagramma attuale. Fare doppio clic su un'associazione ne mostra le proprietà, e a seconda del tipo di associazione qui puoi modificare alcuni parametri, come l'impostazione di molteplicità e il nome del ruolo. Se l'associazione non permette la modifica di queste opzioni, la finestra Proprietà dell'associazione è di sola lettura, e puoi modificare solo la documentazione associata a questa associazione. </para> +<para +>Questa pagina è disponibile solo se apri le Proprietà della classe da un diagramma. Se selezioni le proprietà della classe dal menu contestuale nella Vista ad albero questa pagina non è disponibile. </para> +</sect3> +<sect3 id="class-display-page"> +<title +>Pagina di visualizzazione delle classi</title> +<para +>Nella pagina <guilabel +>Opzioni di visualizzazione</guilabel +>, puoi impostare cosa debba essere visualizzato nel diagramma. Una classe può essere mostrata solo come un rettangolo con dentro il nome della classe (utile se hai molte classi nel tuo diagramma, o per ora non sei interessato ai dettagli di ogni classe), o completamente, mostrando pacchetti, stereotipi, e attributi e operazioni con firma completa e visibilità </para> +<para +>A seconda della quantità di informazione che vuoi vedere, puoi selezionare le opzioni corrispondenti in questa pagina. I cambiamenti che fai qui sono solo <emphasis +>opzioni di visualizzazione</emphasis +> del diagramma. Ciò vuol dire che <quote +>nascondere</quote +> le operazioni di una classe non le fa apparire nel diagramma, ma le operazioni sono ancora parte del tuo modello. Questa opzione è disponibile solo se selezioni le proprietà della classe da un diagramma. Se apri le proprietà della classe dalla Vista ad albero, questa pagina manca, perché queste opzioni di visualizzazione, in quel caso, non hanno senso</para> +</sect3> +<sect3 id="class-color-page"> +<title +>Pagina dei colori delle classi</title> +<para +>Nella pagina <guilabel +>Colore oggetto</guilabel +> puoi configurare i colori che vuoi usare per la linea e il riempimento dell'oggetto. Questa opzione ovviamente ha senso solo per le classi visualizzate nei diagrammi, e manca se apri la finestra delle proprietà delle classi dalla Vista ad albero. </para> +</sect3> +</sect2> + +<sect2 id="associations"> +<title +>Associazioni</title> +<para +>Le associazioni mettono in relazione due oggetti &UML;. Normalmente le associazioni sono definite tra due classi, ma alcuni tipi di associazioni possono esistere anche tra casi d'uso e attori. </para> +<para +>Per creare un'associazione seleziona lo strumento appropriato dalla barra degli strumenti di lavoro (associazione generica, generalizzazione, aggregazione, &etc;), fai clic sul primo elemento che partecipa all'associazione e quindi fai clic sul secondo elemento partecipante. Nota che ci sono due clic, uno su ciascuno degli oggetti partecipanti all'associazione, <emphasis +>non</emphasis +> è un trascinamento da un oggetto all'altro. </para> +<para +>Se provi a usare un'associazione in un modo contrario alla specificazione &UML;, &umbrello; si rifiuterà di creare l'associazione e riceverai un messaggio d'errore. Sarebbe il caso se, per esempio, esistesse una generalizzazione dalla classe A alla classe B e quindi provassi a creare un'altra generalizzazione dalla classe B alla classe A </para> +<para +>Fare clic <mousebutton +>destro</mousebutton +> su un'associazione mostrerà un menu contestuale con le azioni che puoi applicarci. Se devi eliminare un'associazione seleziona semplicemente l'opzione <guimenuitem +>Elimina</guimenuitem +> da questo menu contestuale. Puoi anche selezionare l'opzione <guimenuitem +>Proprietà</guimenuitem +> e, a seconda del tipo di associazione, modificare attributi come ruoli e molteplicità. </para> +<sect3 id="anchor-points"> +<title +>Punti di ancoraggio</title> +<para +>Le associazioni sono disegnate, come impostazione predefinita, come una linea retta che connette i due oggetti nel diagramma. </para> +<para +>Puoi aggiungere dei punti di ancoraggio per piegare un'associazione facendo <mousebutton +>doppio</mousebutton +> clic da qualche parte lungo la linea di associazione. Ciò inserirà un punto di ancoraggio (mostrato come un punto blu quando la linea di associazione è selezionata) che puoi spostare per dare forma all'associazione </para> +<para +>Se hai bisogno di rimuovere un punto di ancoraggio, facci di nuovo <mousebutton +>doppio</mousebutton +> clic per rimuoverlo </para> +<para +>Nota che l'unico modo di modificare le proprietà di un'associazione è con il menu contestuale. Se provi a farci <mousebutton +>doppio</mousebutton +> clic come su qualsiasi altro oggetto &UML;, verrà soltanto inserito un punto di ancoraggio. </para> +</sect3> +</sect2> + +<sect2 id="notes"> +<title +>Note, testo e riquadri</title> +<para +>Le note, le righe di testo e i riquadri sono elementi che possono essere presenti in ogni tipo di diagramma e non avere nessun valore semantico, ma sono molto utili per aggiungere dei commenti o delle spiegazioni che possono rendere il tuo diagramma più facile da capire. </para> +<para +>Per aggiungere una nota o una riga di testo, seleziona lo strumento corrispondente dalla barra degli strumenti di lavoro, e fai clic sul diagramma dove vuoi mettere il tuo commento. Puoi modificare il testo aprendo l'elemento con il menu contestuale o, nel caso delle note, anche facendoci <mousebutton +>doppio</mousebutton +> clic. </para> +<sect3 id="anchors"> +<title +>Ancore</title> +<para +>Le ancore sono usate per collegare insieme una nota di testo e un altro elemento &UML;. Per esempio, normalmente usi una nota di testo per spiegare o fare qualche commento su una classe o un'associazione particolare, nel qual caso puoi usare l'àncora per mettere in chiaro che la nota <quote +>appartiene</quote +> a quell'elemento particolare. </para> +<para +>Per aggiungere un'àncora tra una nota e un altro elemento &UML;, usa lo strumento àncora dalla barra degli strumenti di lavoro. Devi innanzi tutto fare clic sulla nota e quindi sull'elemento &UML; che vuoi collegare alla nota. </para> +</sect3> +</sect2> +</sect1> +</chapter> +<!--edit-diagram--> |