@@ -508,7 +508,7 @@ public void setField(Map<Field, String> fields) {
508
508
/**
509
509
* Set a field, and notify listeners about the change.
510
510
*
511
- * @param field The field to set
511
+ * @param field The field to set
512
512
* @param value The value to set
513
513
* @param eventSource Source the event is sent from
514
514
*/
@@ -543,16 +543,15 @@ public Optional<FieldChange> setField(Field field, String value, EntriesEventSou
543
543
/**
544
544
* Set a field, and notify listeners about the change.
545
545
*
546
- * @param field The field to set.
546
+ * @param field The field to set.
547
547
* @param value The value to set.
548
548
*/
549
549
public Optional <FieldChange > setField (Field field , String value ) {
550
550
return setField (field , value , EntriesEventSource .LOCAL );
551
551
}
552
552
553
553
/**
554
- * Remove the mapping for the field name, and notify listeners about
555
- * the change.
554
+ * Remove the mapping for the field name, and notify listeners about the change.
556
555
*
557
556
* @param field The field to clear.
558
557
*/
@@ -588,9 +587,9 @@ public Optional<FieldChange> clearField(Field field, EntriesEventSource eventSou
588
587
* database argument is given, this method will try to look up missing fields in
589
588
* entries linked by the "crossref" field, if any.
590
589
*
591
- * @param fields An array of field names to be checked.
592
- * @param database The database in which to look up crossref'd entries, if any. This
593
- * argument can be null, meaning that no attempt will be made to follow crossrefs.
590
+ * @param fields An array of field names to be checked.
591
+ * @param database The database in which to look up crossref'd entries, if any. This argument can be null, meaning
592
+ * that no attempt will be made to follow crossrefs.
594
593
* @return true if all fields are set or could be resolved, false otherwise.
595
594
*/
596
595
public boolean allFieldsPresent (Collection <OrFields > fields , BibDatabase database ) {
@@ -610,9 +609,11 @@ public Object clone() {
610
609
611
610
/**
612
611
* This returns a canonical BibTeX serialization. Special characters such as "{" or "&" are NOT escaped, but written
613
- * as is
612
+ * as is. In case the JabRef "hack" for distinguishing "field = value" and "field = {value}" (in .bib files) is
613
+ * used, it is output as "field = {#value#}", which may cause headaches in debugging. We nevertheless do it this way
614
+ * to a) enable debugging the internal representation and b) save time at this method.
614
615
* <p>
615
- * Serializes all fields, even the JabRef internal ones. Does NOT serialize "KEY_FIELD" as field, but as key
616
+ * Serializes all fields, even the JabRef internal ones. Does NOT serialize "KEY_FIELD" as field, but as key.
616
617
*/
617
618
@ Override
618
619
public String toString () {
0 commit comments