Skip to main content
Top

2016 | OriginalPaper | Chapter

On Comments in Visual Languages

Authors : Christoph Daniel Schulze, Christina Plöger, Reinhard von Hanxleden

Published in: Diagrammatic Representation and Inference

Publisher: Springer International Publishing

Activate our intelligent search to find suitable subject content or patents.

search-config
loading …

Abstract

Visual languages based on node-link diagrams can be used to develop software and usually offer the possibility to write explanatory comments. Which node a comment refers to is usually not made explicit, but is implicitly clear to readers through placement and content. While automatic layout algorithms can make working with diagrams more productive, they tend to destroy such implicit clues because they are not aware of them and thus do not preserve the spatial relationship between diagram elements. Implicit clues thus need to be inferred and made explicit to be taken into account by layout algorithms. In this paper, we improve upon a previous paper on the subject [9], introducing further heuristics that aim to describe relations between comments and nodes. These heuristics mainly help to reduce the number of attachments of comments that should not be attached to anything. We also derive propositions on how developers of visual languages should integrate comments.

Dont have a licence yet? Then find out more about our products and how to get one now:

Springer Professional "Wirtschaft+Technik"

Online-Abonnement

Mit Springer Professional "Wirtschaft+Technik" erhalten Sie Zugriff auf:

  • über 102.000 Bücher
  • über 537 Zeitschriften

aus folgenden Fachgebieten:

  • Automobil + Motoren
  • Bauwesen + Immobilien
  • Business IT + Informatik
  • Elektrotechnik + Elektronik
  • Energie + Nachhaltigkeit
  • Finance + Banking
  • Management + Führung
  • Marketing + Vertrieb
  • Maschinenbau + Werkstoffe
  • Versicherung + Risiko

Jetzt Wissensvorsprung sichern!

Springer Professional "Technik"

Online-Abonnement

Mit Springer Professional "Technik" erhalten Sie Zugriff auf:

  • über 67.000 Bücher
  • über 390 Zeitschriften

aus folgenden Fachgebieten:

  • Automobil + Motoren
  • Bauwesen + Immobilien
  • Business IT + Informatik
  • Elektrotechnik + Elektronik
  • Energie + Nachhaltigkeit
  • Maschinenbau + Werkstoffe




 

Jetzt Wissensvorsprung sichern!

Springer Professional "Wirtschaft"

Online-Abonnement

Mit Springer Professional "Wirtschaft" erhalten Sie Zugriff auf:

  • über 67.000 Bücher
  • über 340 Zeitschriften

aus folgenden Fachgebieten:

  • Bauwesen + Immobilien
  • Business IT + Informatik
  • Finance + Banking
  • Management + Führung
  • Marketing + Vertrieb
  • Versicherung + Risiko




Jetzt Wissensvorsprung sichern!

Literature
1.
go back to reference Buse, R.P., Weimer, W.R.: Automatic documentation inference for exceptions. In: Proceedings of the 2008 International Symposium on Software Testing and Analysis, ISSTA 2008, pp. 273–282. ACM (2008) Buse, R.P., Weimer, W.R.: Automatic documentation inference for exceptions. In: Proceedings of the 2008 International Symposium on Software Testing and Analysis, ISSTA 2008, pp. 273–282. ACM (2008)
2.
go back to reference Eichelberger, H.: Aesthetics and automatic layout of UML class diagrams. Ph.D. thesis, Bayerische Julius-Maximilians-Universität Würzburg (2005) Eichelberger, H.: Aesthetics and automatic layout of UML class diagrams. Ph.D. thesis, Bayerische Julius-Maximilians-Universität Würzburg (2005)
3.
go back to reference Kramer, D.: API documentation from source code comments: a case study of Javadoc. In: Proceedings of the 17th Annual International Conference on Computer Documentation, SIGDOC 1999, pp. 147–153. ACM (1999) Kramer, D.: API documentation from source code comments: a case study of Javadoc. In: Proceedings of the 17th Annual International Conference on Computer Documentation, SIGDOC 1999, pp. 147–153. ACM (1999)
4.
go back to reference Misue, K., Eades, P., Lai, W., Sugiyama, K.: Layout adjustment and the mental map. J. Vis. Lang. Comput. 6(2), 183–210 (1995)CrossRef Misue, K., Eades, P., Lai, W., Sugiyama, K.: Layout adjustment and the mental map. J. Vis. Lang. Comput. 6(2), 183–210 (1995)CrossRef
5.
go back to reference Petre, M.: Cognitive dimensions beyond the notation. J. Vis. Lang. Comput. 17(4), 292–301 (2006)CrossRef Petre, M.: Cognitive dimensions beyond the notation. J. Vis. Lang. Comput. 17(4), 292–301 (2006)CrossRef
7.
go back to reference Schulze, C.D., Plöger, C., von Hanxleden, R.: On comments in visual languages. Technical report 1602, Christian-Albrechts-Universität zu Kiel, Department of Computer Science, April 2016. ISSN: 2192–6247 Schulze, C.D., Plöger, C., von Hanxleden, R.: On comments in visual languages. Technical report 1602, Christian-Albrechts-Universität zu Kiel, Department of Computer Science, April 2016. ISSN: 2192–6247
8.
go back to reference Schulze, C.D., Spönemann, M., von Hanxleden, R.: Drawing layered graphs with port constraints. J. Vis. Lang. Comput. Spec. Issue Diagram Aesthetics Layout 25(2), 89–106 (2014)CrossRef Schulze, C.D., Spönemann, M., von Hanxleden, R.: Drawing layered graphs with port constraints. J. Vis. Lang. Comput. Spec. Issue Diagram Aesthetics Layout 25(2), 89–106 (2014)CrossRef
9.
go back to reference Schulze, C.D., von Hanxleden, R.: Automatic layout in the face of unattached comments. In: Proceedings of the IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC 2014), Melbourne, Australia, July 2014 Schulze, C.D., von Hanxleden, R.: Automatic layout in the face of unattached comments. In: Proceedings of the IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC 2014), Melbourne, Australia, July 2014
10.
go back to reference Sugiyama, K., Tagawa, S., Toda, M.: Methods for visual understanding of hierarchical system structures. IEEE Trans. Syst. Man Cybern. 11(2), 109–125 (1981)MathSciNetCrossRef Sugiyama, K., Tagawa, S., Toda, M.: Methods for visual understanding of hierarchical system structures. IEEE Trans. Syst. Man Cybern. 11(2), 109–125 (1981)MathSciNetCrossRef
Metadata
Title
On Comments in Visual Languages
Authors
Christoph Daniel Schulze
Christina Plöger
Reinhard von Hanxleden
Copyright Year
2016
DOI
https://doi.org/10.1007/978-3-319-42333-3_17