Just a couple of minor questions: > 1) Unicode characters in comments, this causes compilation > failures in some locales (notably C locale).
Do you know of some simple program I could run to check for this and stop it happening in the future (I have never used vi or Emacs as I did not want to learn the keycodes) > 5) Documentation for your functions shows poorly in HyperDoc. > The normal style is to write something like: > > ++ addArrow!(s, nm, o1, o2) adds an arrow to the graph s,where: > ++ nm is the name of the arrow > ++ o1 is the start object > ++ o2 is the end object > > You wrote: > > addArrow!:(s:%,name:String,n1:NNI,n2:NNI) -> % > ++ adds an arrow to this graph,where: > ++ s is the graph where the arrow is to be added > ++ nm is the name of the arrow > ++ n1 is the index of the start object > ++ n2 is the index of the end object > > Unfortunatly, Spad compiler simply ignores names given in the > first line, so HypeDoc shows: > > addArrow!(x, y, i, j) > > ++ adds an arrow to this graph,where: > ++ s is the graph where the arrow is to be added > ++ nm is the name of the arrow > ++ n1 is the index of the start object > ++ n2 is the index of the end object > > and the user has no idea what are correct arguments to the > function. Yes I keep getting a lot of compiler warnings about the documentation, there are so many compiler warnings that I just ignore them, however I was going to try to investigate this when I found time. Is there any documentation about the documentation that explains what it is trying to enforce and why? Martin -- You received this message because you are subscribed to the Google Groups "FriCAS - computer algebra system" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/fricas-devel?hl=en.
